Questa pagina mostra come attivare, disattivare e controllare lo stato della funzionalità Autoclass, impostata su un bucket in Cloud Storage.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per impostare e gestire Autoclass su un bucket, chiedi all'amministratore di concederti il ruolo IAM Amministratore archiviazione (roles/storage.admin
) sul bucket. Questo ruolo predefinito contiene
le autorizzazioni necessarie per impostare e gestire Autoclass su un bucket. Per vedere quali sono esattamente le autorizzazioni
richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.list
- Questa autorizzazione è necessaria solo per utilizzare la console Google Cloud per eseguire le attività in questa pagina.
storage.buckets.update
Puoi anche ottenere queste autorizzazioni con ruoli personalizzati.
Per informazioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket.
Impostare Autoclass per un bucket
Per impostare Autoclass per un bucket, completa le seguenti istruzioni:
Console
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che ti interessa.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Fai clic sull'icona Modifica (edit) per Classe di archiviazione predefinita.
Nella finestra di overlay, seleziona Autoclass per attivare Autoclass. Per disattivare la classificazione automatica, seleziona Imposta una classe predefinita, quindi seleziona una classe di archiviazione predefinita per il bucket.
Fai clic su Conferma.
Per cambiare la classe di archiviazione terminale per un bucket in cui è attivato Autoclass, fai clic sull'icona Modifica (edit) per Classi incluse e fai clic su Conferma nella finestra di overlay visualizzata.
Riga di comando
Utilizza il comando gcloud storage buckets update
con i flag appropriati:
gcloud storage buckets update gs://BUCKET_NAME --default-storage-class=DEFAULT_CLASS AUTOCLASS_FLAG
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.DEFAULT_CLASS
imposta i metadati della classe di archiviazione per il bucket. Quando abiliti Autoclass,STANDARD
è l'unico valore valido ed è obbligatorio se il bucket utilizza attualmente una classe di archiviazione diversa.AUTOCLASS_FLAG
è uno dei seguenti:--enable-autoclass
per attivare Autoclass.--no-enable-autoclass
per disattivare Autoclass.--autoclass-terminal-storage-class=CLASS
per impostare la classe di archiviazione terminale per Autoclass. CLASS può essereNEARLINE
oARCHIVE
. Quando utilizzi questo flag in un bucket con Autoclass disattivato, includi anche il flag--enable-autoclass
nel comando.
Se l'operazione ha esito positivo, la risposta è simile al seguente esempio:
Updating gs://my-bucket/... Completed 1
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
API REST
API JSON
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Crea un file JSON contenente le seguenti informazioni:
{ "storageClass": "DEFAULT_CLASS", "autoclass": { "enabled": BOOLEAN, "terminalStorageClass":TERMINAL_CLASS } }
Dove:
DEFAULT_CLASS
imposta i metadati della classe di archiviazione per il bucket. Quando abiliti Autoclass,STANDARD
è l'unico valore valido ed è obbligatorio se il bucket utilizza attualmente una classe di archiviazione diversa.BOOLEAN
ètrue
per attivare Autoclass ofalse
per disattivare Autoclass.TERMINAL_CLASS
è la classe di archiviazione terminale da utilizzare quando Autoclass è abilitato.
Utilizza
cURL
per chiamare l'API JSON con una richiestaPATCH
Bucket:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=autoclass"
Dove:
JSON_FILE_NAME
è il percorso del file JSON che hai creato nel passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
Questa funzionalità non può essere gestita tramite l'API XML. Utilizza la consoleGoogle Cloud o un altro strumento.
Visualizzare lo stato di Autoclass di un bucket
Per visualizzare lo stato di Autoclass per un singolo bucket:
Console
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Fai clic sul nome del bucket di cui vuoi controllare lo stato.
Fai clic sulla scheda Configuration (Configurazione).
Lo stato di Autoclass viene visualizzato nel campo Classe di archiviazione predefinita.
Se Autoclass è abilitata, il campo indica Gestito con Autoclass e il campo Classi incluse mostra le classi di archiviazione tra cui possono essere trasferiti gli oggetti.
Riga di comando
Utilizza il comando gcloud storage buckets describe
con il flag
--format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(autoclass)"
Dove BUCKET_NAME
è il nome del bucket
di cui vuoi visualizzare lo stato. Ad esempio, my-bucket
.
Se l'operazione ha esito positivo, la risposta è simile al seguente esempio:
autoclass: enabled: true terminalStorageClass: ARCHIVE terminalStorageClassUpdateTime: '2023-02-10T16:11:02.384000+00:00' toggleTime: '2022-11-09T16:01:40.775000+00:00'
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
API REST
API JSON
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiestaGET
Bucket che includa il campoautoclass
:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=autoclass"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.Se il bucket ha Autoclass abilitato, la risposta è simile al seguente esempio:
{ "autoclass": { "enabled": "BOOLEAN", "toggleTime": "DATETIME", "terminalStorageClass": "STORAGE_CLASS", "terminalStorageClassUpdateTime": "DATETIME" }, }
API XML
Questa funzionalità non può essere gestita tramite l'API XML. Utilizza la consoleGoogle Cloud o un altro strumento.
Passaggi successivi
- Scopri di più su Autoclass.
- Scopri di più sulla gestione del ciclo di vita degli oggetti, che modifica automaticamente la classe di archiviazione di un oggetto quando soddisfa i criteri specificati.