Questa pagina spiega 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 in un bucket,
chiedi all'amministratore di concederti il ruolo IAM Amministratore archiviazione (roles/storage.admin
)
nel bucket. Questo ruolo predefinito contiene le autorizzazioni necessarie per impostare e gestire Autoclass in un bucket. Per vedere le
le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni obbligatorie
sezione:
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 i ruoli personalizzati.
Per informazioni sulla concessione dei ruoli ai bucket, consulta Utilizzare IAM con i bucket.
Impostare la classe automatica per un bucket
Per impostare Autoclass per un bucket, completa le seguenti istruzioni:
Console
- Nella console Google Cloud, vai alla pagina Bucket di 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) accanto a Classe di archiviazione predefinita.
Nella finestra dell'overlay, seleziona Autoclass per attivare Autoclass. A disattiva Autoclass, seleziona Imposta un corso predefinito, quindi seleziona una predefinita per il bucket.
Fai clic su Conferma.
Per cambiare la classe di archiviazione di destinazione per un bucket in cui è attivata la funzionalità Autoclass, fai clic sull'icona Modifica (edit) per Classi incluse e poi su Conferma nella finestra in overlay visualizzata.
Riga di comando
Utilizza il comando gcloud storage buckets update
con il
flag appropriato:
gcloud storage buckets update gs://BUCKET_NAME FLAG
Dove:
BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.FLAG
corrisponde a uno dei seguenti:--enable-autoclass
per attivare la funzionalità Autoclass.--no-enable-autoclass
per disattivare Autoclass.--autoclass-terminal-storage-class=CLASS
per impostare la classe di archiviazione del terminale per Autoclass. CLASS può essereNEARLINE
oARCHIVE
.
Se l'esito è positivo, la risposta sarà simile al seguente esempio:
Updating gs://my-bucket/... Completed 1
Librerie client
C++
Per ulteriori informazioni, consulta API Cloud Storage C++ documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per autenticarti a Cloud Storage, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta API Cloud Storage Java documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta API Cloud Storage Node.js documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta API Cloud Storage PHP documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per autenticarti a Cloud Storage, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Avere installato e inizializzato l'interfaccia a riga di comando gcloud, che 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
viene l'unico valore valido ed è obbligatorio se il bucket attualmente utilizza una classe di archiviazione diversa.BOOLEAN
ètrue
per attivare la funzionalità Autoclass ofalse
per disattivarla.TERMINAL_CLASS
è la classe di archiviazione finale 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 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 la console Google Cloud o un altro strumento.
Visualizzare lo stato Autoclass di un bucket
Per visualizzare lo stato di Autoclass per un singolo bucket:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Fai clic sul nome del bucket di cui vuoi controllare lo stato.
Fai clic sulla scheda Configuration (Configurazione).
Lo stato per Autoclass viene visualizzato in Classe di archiviazione predefinita .
Se Autoclass è abilitato, il campo indica Gestito con Autoclass. mentre il campo Classi incluse mostra le classi di archiviazione tra cui possono passare.
Riga di comando
Utilizza il comando gcloud storage buckets describe
con
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'esito è positivo, la risposta sarà 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 ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta API Cloud Storage C# documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta API Cloud Storage Go documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta API Cloud Storage Java documentazione di riferimento.
Per autenticarti a Cloud Storage, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta API Cloud Storage Node.js documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta API Cloud Storage PHP documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, che consente generi un token di accesso per l'intestazione
Authorization
.Usa
cURL
per chiamare l'API JSON con una Richiesta diGET
bucket che include 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 nel bucket è abilitato Autoclass, la risposta sarà simile alla nell'esempio seguente:
{ "autoclass": { "enabled": "BOOLEAN", "toggleTime": "DATETIME", "terminalStorageClass": "STORAGE_CLASS", "terminalStorageClassUpdateTime": "DATETIME" }, }
API XML
Questa funzionalità non può essere gestita tramite l'API XML. Utilizza la console Google 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 un di archiviazione quando soddisfa i criteri da te specificati.