Panoramica Esempi di configurazione
Questa pagina descrive come impostare la Gestione del ciclo di vita degli oggetti su un bucket e come per visualizzare l'attuale configurazione del ciclo di vita di un bucket. 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 il ciclo di vita degli oggetti
Gestione di un bucket, chiedi all'amministratore di concederti l'autorizzazione Amministratore Storage
(roles/storage.admin
) nel bucket. Questo ruolo predefinito contiene
le autorizzazioni necessarie per impostare e gestire la Gestione del ciclo di vita degli oggetti per
di sincronizzare la directory di una VM
con un bucket. Per vedere le autorizzazioni esatte richieste, espandi la sezione
Sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.list
- Questa autorizzazione è necessaria solo se prevedi di utilizzare nella console Google Cloud per eseguire le istruzioni in questa pagina.
storage.buckets.update
Potresti anche riuscire a ottenere queste autorizzazioni 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 su il nome del bucket.
Fai clic sulla scheda Ciclo di vita.
Viene visualizzata la pagina Regole del ciclo di vita. Da qui puoi modificare o eliminare regole esistenti. Per aggiungere una nuova regola:
Fai clic su Aggiungi una regola.
Specifica una configurazione nella pagina visualizzata.
Seleziona l'azione da intraprendere quando un oggetto soddisfa le condizioni.
Fai clic su Continua.
Seleziona le condizioni in base alle quali viene intrapresa un'azione.
Fai clic su Continua.
Fai clic su Crea.
Scopri come ottenere informazioni dettagliate sugli errori di Cloud Storage non riusciti nella console Google Cloud, vedi Risoluzione dei problemi.
Riga di comando
Crea un file JSON con le regole di configurazione del ciclo di vita che che desidera applicare. Consulta gli esempi di configurazione JSON.
Utilizza il comando
gcloud storage buckets update
con Flag--lifecycle-file
:gcloud storage buckets update gs://BUCKET_NAME --lifecycle-file=LIFECYCLE_CONFIG_FILE
Dove:
BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.LIFECYCLE_CONFIG_FILE
è il percorso il file JSON che hai creato nel passaggio 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.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
Il seguente esempio rimuove qualsiasi configurazione esistente del ciclo di vita da un bucket:
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.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
Il seguente esempio rimuove qualsiasi configurazione esistente del ciclo di vita da un bucket:
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.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
Il seguente esempio rimuove qualsiasi configurazione esistente del ciclo di vita da un bucket:
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.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
Il seguente esempio rimuove qualsiasi configurazione esistente del ciclo di vita da un bucket:
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 ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
Il seguente esempio rimuove qualsiasi configurazione esistente del ciclo di vita da un bucket:
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.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
Il seguente esempio rimuove qualsiasi configurazione esistente del ciclo di vita da un bucket:
Python
Per ulteriori informazioni, consulta API Cloud Storage Python 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.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
Il seguente esempio rimuove qualsiasi configurazione esistente del ciclo di vita da un bucket:
Ruby
Per ulteriori informazioni, consulta API Cloud Storage Ruby 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.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
Il seguente esempio rimuove qualsiasi configurazione esistente del ciclo di vita da un bucket:
Terraform
Puoi utilizzare una risorsa Terraform per impostare un ciclo di vita per un bucket gestito da Terraform. Per impostare un 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
Documentazione di Terraform per il blocco condition
.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Crea un file JSON con le regole di configurazione del ciclo di vita che che desidera applicare. Vedi gli esempi di configurazione per esempi JSON.
Utilizza
cURL
per chiamare l'API JSON con un RichiestaPATCH
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 il file JSON che hai creato nel passaggio 2.BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.
API XML
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Creare un file XML con le regole di configurazione del ciclo di vita che vuoi applicare. Consulta gli esempi di configurazione XML.
Utilizza
cURL
per chiamare l'API XML con un RichiestaPUT
bucket elifecycle
parametro di stringa di query: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 creato nel passaggio 2.BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.
Controlla 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 viene indicato lo stato del ciclo di vita di ciascun bucket nella colonna Ciclo di vita.
Puoi fare clic su questo stato per aggiungere, visualizzare, modificare ed eliminare le regole.
Scopri come ottenere informazioni dettagliate sugli errori di Cloud Storage non riusciti nella console Google Cloud, vedi Risoluzione dei problemi.
Riga di comando
Utilizza il comando gcloud storage buckets describe
con
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 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 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.
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 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.
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 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.
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 ulteriori informazioni, consulta API Cloud Storage Node.js 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.
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 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.
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 ulteriori informazioni, consulta API Cloud Storage Python 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.
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 ulteriori informazioni, consulta API Cloud Storage Ruby 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.
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
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con un RichiestaGET
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 del bucket pertinente. Ad esempio,my-bucket
.
API XML
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con un RichiestaGET
bucket 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 del bucket pertinente. Ad esempio,my-bucket
.
Passaggi successivi
- Scopri di più sulla Gestione del ciclo di vita degli oggetti, incluse le le azioni e le condizioni del ciclo di vita.
- Esplora gli esempi di configurazione del ciclo di vita.