Disattivare Drive per una casella via API

Lo spazio di archiviazione è condiviso in tutto l’account, quindi una persona che usa Drive come cloud personale consuma lo spazio necessario agli altri per la posta. Ogni casella ha un livello drive_access che stabilisce a quali funzioni di Drive può accedere il suo utente. Questa pagina è il riferimento dei comandi per configurarlo.

La stessa impostazione è disponibile nel pannello in Caselle → (una casella) → Limiti. È inclusa in ogni piano e non prevede costi aggiuntivi.

I tre livelli

full è il valore predefinito ed è attivo su tutte le caselle esistenti. La ricezione non viene mai interessata: un allegato di grandi dimensioni inviato alla casella si apre dalla webmail come sempre, con qualsiasi livello.

Ambito richiesto

mailboxes:write, lo stesso ambito usato per aggiornare qualsiasi altro campo di una casella. Entrambi gli endpoint seguenti accettano l’header Idempotency-Key e possono essere richiamati nuovamente in sicurezza.

Una casella

curl -s -X PATCH "https://trekmail.net/api/v1/mailboxes/{MAILBOX_ID}" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: drive-access-{MAILBOX_ID}-off" \
  -d '{"drive_access":"disabled"}'

La casella aggiornata viene restituita con il nuovo livello:

{ "data": { "id": 1701, "email": "sam@example.com", "drive_access": "disabled", "...": "..." } }

drive_access viene restituito anche da GET /api/v1/mailboxes/{id} e dall’endpoint di elenco, quindi puoi controllare il valore impostato senza modificare nulla.

Più caselle contemporaneamente

curl -s -X POST "https://trekmail.net/api/v1/mailboxes:drive-access" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: drive-access-domain-123-off" \
  -d '{"domain_id":123,"drive_access":"disabled"}'

Fornisci esattamente un selettore:

La risposta indica che cosa è successo:

{ "data": { "drive_access": "disabled", "matched": 24, "updated": 21, "skipped_shared": 3 } }

matched è il numero di caselle trovate dal selettore, mentre updated è il numero di quelle effettivamente modificate. Le caselle già impostate sul livello richiesto vengono incluse tra le corrispondenze ma non aggiornate, quindi ripetere la chiamata non causa problemi. È utile quando applichi periodicamente un valore predefinito alle nuove caselle.

Applicarlo alle nuove caselle

La creazione di una casella non accetta drive_access; le nuove caselle iniziano con full. Per predisporre una casella che non abbia mai avuto Drive, creala e poi imposta il livello:

# 1. Create the mailbox. The server generates the one-time password and returns it once.
curl -s -X POST "https://trekmail.net/api/v1/mailboxes" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-mailbox-sam" \
  -d '{"domain_id":123,"local_part":"sam","password_mode":"generated_one_time"}'

# 2. Turn off Drive using the id returned above.
curl -s -X PATCH "https://trekmail.net/api/v1/mailboxes/1701" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: drive-access-1701-off" \
  -d '{"drive_access":"disabled"}'

Se crei le caselle in gruppi, il metodo più semplice consiste nel crearle tutte e poi effettuare un’unica chiamata in blocco con domain_id.

Con un agente MCP

set_mailboxes_drive_access(domain_id=123, drive_access="disabled")

Lo strumento accetta gli stessi tre selettori dell’endpoint REST e restituisce gli stessi conteggi. Per una singola casella funziona anche update_mailbox(mailbox_id=1701, drive_access="disabled").

Caselle condivise

L’endpoint singolo rifiuta le caselle condivise con 422 drive_access_not_applicable. L’endpoint in blocco le ignora, ma le include comunque nel conteggio. Nessuno accede direttamente a una casella condivisa: il team la apre dalla propria casella, quindi viene applicato il livello della casella di quel membro. Chi non dispone più di Drive non può accedere ai file di una casella condivisa né usarla per aggirare l’impostazione.

Che cosa vede una casella con restrizioni

La restrizione viene applicata ovunque e non è semplicemente nascosta nell’interfaccia:

• il suo spazio Drive non compare in GET /api/v1/drive/spaces
• i suoi file rispondono con 404 quando vengono richiesti per id
• non è possibile creare un dispositivo di sincronizzazione per la casella; POST /api/v1/drive/devices restituisce 422 drive_disabled
• nella webmail non compaiono Drive nella barra laterale, il caricamento tramite trascinamento né i risultati di Drive nella ricerca

Quando cambi livello non viene eliminato nulla. I file già archiviati rimangono al loro posto e la persona semplicemente non può accedervi. Questo significa anche che la disattivazione di Drive non restituisce automaticamente lo spazio. La scheda Limiti del pannello mostra quanto contiene una casella e permette di eliminare definitivamente quei file se vuoi recuperare lo spazio.

Errori possibili