Panoramica Esempi di configurazione
Questa pagina descrive come impostare la Gestione del ciclo di vita degli oggetti su un bucket e come visualizzare l'attuale configurazione del ciclo di vita di un bucket. Le configurazioni del ciclo di vita si applicano a tutti gli oggetti attuali e futuri nel bucket.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per impostare e gestire la Gestione del ciclo di vita degli oggetti per un bucket, chiedi all'amministratore di concederti il ruolo Amministratore Storage (roles/storage.admin
) per il bucket. Questo ruolo predefinito contiene le autorizzazioni necessarie per impostare e gestire la gestione del ciclo di vita degli oggetti per un bucket. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.list
- Questa autorizzazione è necessaria solo se prevedi di utilizzare la console Google Cloud per eseguire le istruzioni in questa pagina.
storage.buckets.update
Potresti essere in grado di ottenere queste autorizzazioni anche con i ruoli personalizzati.
Per informazioni sulla concessione dei ruoli nei bucket, consulta Utilizzare IAM con i bucket.
Imposta la configurazione del ciclo di vita per un bucket
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, trova il bucket da abilitare e fai clic sul suo nome.
Fai clic sulla scheda Ciclo di vita.
Viene visualizzata la pagina Regole del ciclo di vita. Da qui puoi modificare o eliminare le regole esistenti. Per aggiungere una nuova regola:
Fai clic su Aggiungi una regola.
Nella pagina visualizzata, specifica una configurazione.
Seleziona l'azione da eseguire quando un oggetto soddisfa le condizioni.
Fai clic su Continua.
Seleziona le conditions in base alle quali viene intrapresa un'azione.
Fai clic su Continua.
Fai clic su Crea.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud, consulta Risoluzione dei problemi.
Riga di comando
Crea un file JSON con le regole di configurazione del ciclo di vita che vuoi applicare. Guarda gli esempi di configurazione per trovare file JSON di esempio.
Utilizza il comando
gcloud storage buckets update
con il flag--lifecycle-file
:gcloud storage buckets update gs://BUCKET_NAME --lifecycle-file=LIFECYCLE_CONFIG_FILE
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.LIFECYCLE_CONFIG_FILE
è il percorso del file JSON creato nel passaggio 1.
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione del ciclo di vita in un bucket:
L'esempio seguente rimuove qualsiasi configurazione del ciclo di vita esistente da un bucket:
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione del ciclo di vita in un bucket:
L'esempio seguente rimuove qualsiasi configurazione del ciclo di vita esistente da un bucket:
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione del ciclo di vita in un bucket:
L'esempio seguente rimuove qualsiasi configurazione del ciclo di vita esistente da un bucket:
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione del ciclo di vita in un bucket:
L'esempio seguente rimuove qualsiasi configurazione del ciclo di vita esistente da un bucket:
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione del ciclo di vita in un bucket:
L'esempio seguente rimuove qualsiasi configurazione del ciclo di vita esistente da un bucket:
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione del ciclo di vita in un bucket:
L'esempio seguente rimuove qualsiasi configurazione del ciclo di vita esistente da un bucket:
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione del ciclo di vita in un bucket:
L'esempio seguente rimuove qualsiasi configurazione del ciclo di vita esistente da un bucket:
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione del ciclo di vita in un bucket:
L'esempio seguente rimuove qualsiasi configurazione del ciclo di vita esistente da un bucket:
Terraform
Puoi utilizzare una risorsa Terraform per impostare una configurazione del ciclo di vita per un bucket gestito da Terraform. Per impostare una configurazione del ciclo di vita su un bucket esistente non ancora gestito da Terraform, devi prima importare il bucket esistente.
Per scoprire se una condizione del ciclo di vita è supportata da Terraform, consulta la documentazione di Terraform per il blocco condition
.
API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Crea un file JSON con le regole di configurazione del ciclo di vita che vuoi applicare. Guarda gli esempi di configurazione per trovare file JSON di esempio.
Utilizza
cURL
per chiamare l'API JSON con una richiestaPATCH
di bucket:curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Dove:
LIFECYCLE_CONFIG_FILE
è il percorso del file JSON creato nel passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Crea un file XML con le regole di configurazione del ciclo di vita che vuoi applicare. Consulta gli esempi di configurazione per alcuni file XML di esempio.
Utilizza
cURL
per chiamare l'API XML con una richiesta BucketPUT
e un parametro della stringa di querylifecycle
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
Dove:
XML_FILE_NAME
è il percorso del file XML che hai creato nel passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Verificare la configurazione del ciclo di vita di un bucket
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, lo stato del ciclo di vita di ogni bucket si trova nella colonna Ciclo di vita.
Puoi fare clic su questo stato per aggiungere, visualizzare, modificare ed eliminare le regole.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud, consulta Risoluzione dei problemi.
Riga di comando
Utilizza il comando gcloud storage buckets describe
con il flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(lifecycle_config)"
dove BUCKET_NAME
è il nome del bucket
di cui vuoi visualizzare la configurazione del ciclo di vita. Ad esempio,
my-bucket
.
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca i campi dei criteri del ciclo di vita nella risposta.Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca i campi dei criteri del ciclo di vita nella risposta.Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca i campi dei criteri del ciclo di vita nella risposta.Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca i campi dei criteri del ciclo di vita nella risposta.PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca i campi dei criteri del ciclo di vita nella risposta.Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca i campi dei criteri del ciclo di vita nella risposta.Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati di un bucket e cerca i campi dei criteri del ciclo di vita nella risposta.API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiestaGET
di bucket:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiesta BucketGET
e un parametro della stringa di querylifecycle
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Passaggi successivi
- Scopri di più sulla gestione del ciclo di vita degli oggetti, incluse le azioni del ciclo di vita disponibili e le condizioni del ciclo di vita.
- Esplora gli esempi di configurazione del ciclo di vita.