In questa pagina viene descritto come impostare la gestione del ciclo di vita degli oggetti in un bucket e come visualizzare la configurazione del ciclo di vita attuale di un bucket. Le configurazioni del ciclo di vita si applicano a tutti gli oggetti correnti e futuri nel bucket.
Prerequisiti
I prerequisiti possono variare in base allo strumento utilizzato:
Console
Per completare questa guida utilizzando Google Cloud Console, devi disporre delle autorizzazioni IAM appropriate. Se il bucket a cui vuoi accedere esiste in un progetto non creato da te, potresti dover chiedere al proprietario del progetto di concederti un ruolo con le autorizzazioni necessarie.
Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta Autorizzazioni IAM per Google Cloud Console.
Per un elenco dei ruoli pertinenti, consulta Ruoli di Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
Riga di comando
Per completare questa guida utilizzando un'utilità a riga di comando, devi disporre delle autorizzazioni IAM appropriate. Se il bucket a cui vuoi accedere esiste in un progetto che non hai creato, potresti avere bisogno del proprietario del progetto per assegnarti un ruolo contenente le autorizzazioni necessarie.
Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta Autorizzazioni IAM per comandi gsutil.
Per un elenco dei ruoli pertinenti, consulta Ruoli di Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
Esempi di codice
Per completare questa guida utilizzando le librerie client di Cloud Storage, devi disporre delle autorizzazioni IAM appropriate. Se il bucket a cui vuoi accedere esiste in un progetto che non hai creato, potrebbe essere necessario che il proprietario del progetto ti conceda un ruolo contenente le autorizzazioni necessarie. Se non diversamente indicato, le richieste della libreria client vengono effettuate tramite l'API JSON.
Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta le autorizzazioni IAM per i metodi JSON.
Per un elenco dei ruoli pertinenti, consulta Ruoli di Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
API REST
API JSON
Per completare questa guida utilizzando l'API JSON, devi disporre delle autorizzazioni IAM appropriate. Se il bucket a cui vuoi accedere esiste in un progetto non creato da te, potresti dover chiedere al proprietario del progetto di assegnarti un ruolo contenente le autorizzazioni necessarie.
Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta le autorizzazioni IAM per i metodi JSON.
Per un elenco dei ruoli pertinenti, consulta Ruoli di Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
Imposta la configurazione del ciclo di vita per un bucket
Console
- In Google Cloud Console, vai alla pagina Browser di Cloud Storage.
Nell'elenco dei bucket, trova il bucket da abilitare e fai clic sul 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 le regole esistenti. Per aggiungere una nuova regola:
Fai clic su Aggiungi una regola.
Specifica una configurazione nella pagina visualizzata.
Seleziona l'azione da eseguire 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.
Per informazioni dettagliate sugli errori nelle operazioni non riuscite nel browser di Cloud Storage, consulta la sezione Risoluzione dei problemi.
Riga di comando
Crea un file JSON con le regole di configurazione del ciclo di vita che vuoi applicare. Consulta gli esempi di configurazione per alcuni file JSON di esempio.
Utilizza il comando
gsutil lifecycle set
per applicare la configurazione:gsutil lifecycle set LIFECYCLE_CONFIG_FILE gs://BUCKET_NAME
Dove:
LIFECYCLE_CONFIG_FILE
è il percorso del file JSON che hai creato nel passaggio 1.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Esempi di codice
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
L'esempio seguente rimuove qualsiasi configurazione di ciclo di vita esistente da un bucket:
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C# .
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
L'esempio seguente rimuove qualsiasi configurazione di ciclo di vita esistente da un bucket:
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
L'esempio seguente rimuove qualsiasi configurazione di ciclo di vita esistente da un bucket:
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
L'esempio seguente rimuove qualsiasi configurazione di ciclo di vita esistente da un bucket:
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
L'esempio seguente rimuove qualsiasi configurazione di ciclo di vita esistente da un bucket:
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
L'esempio seguente rimuove qualsiasi configurazione di ciclo di vita esistente da un bucket:
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
L'esempio seguente rimuove qualsiasi configurazione di ciclo di vita esistente da un bucket:
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
L'esempio seguente imposta una configurazione del ciclo di vita su un bucket:
L'esempio seguente rimuove qualsiasi configurazione di ciclo di vita esistente da un bucket:
API REST
API JSON
- Ottieni un token di accesso all'autorizzazione da OAuth 2.0 Playground. Configura il parco giochi in modo che utilizzi le tue credenziali OAuth. Per le istruzioni, consulta la pagina relativa all'autenticazione API.
Crea un file JSON con le regole di configurazione del ciclo di vita che vuoi applicare. Vedi gli esempi di configurazione per i file JSON di esempio.
Utilizza
cURL
per chiamare l'API JSON con una richiesta diPATCH
bucket:curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE \ -H "Authorization: Bearer OAUTH2_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 che hai creato nel passaggio 2.OAUTH2_TOKEN
è il token di accesso che hai generato nel passaggio 1.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
- Ottieni un token di accesso all'autorizzazione da OAuth 2.0 Playground. Configura il parco giochi in modo che utilizzi le tue credenziali OAuth. Per le istruzioni, consulta la pagina relativa all'autenticazione API.
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 richiestaPUT
di bucket:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
Dove:
XML_FILE_NAME
è il percorso del file XML che hai creato nel passaggio 2.OAUTH2_TOKEN
è il token di accesso che hai generato nel passaggio 1.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Controlla la configurazione del ciclo di vita per un bucket
Console
- In Google Cloud Console, vai alla pagina Browser di Cloud Storage.
Nell'elenco dei bucket, lo stato del ciclo di vita di ciascun bucket è indicato nella colonna Ciclo di vita.
Puoi fare clic su questo stato per aggiungere, visualizzare, modificare ed eliminare le regole.
Per informazioni dettagliate sugli errori nelle operazioni non riuscite nel browser di Cloud Storage, consulta la sezione Risoluzione dei problemi.
Riga di comando
Utilizza il comando
gsutil lifecycle get
:gsutil lifecycle get gs://BUCKET_NAME
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Esempi di codice
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C# .
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca i campi del criterio del ciclo di vita nella risposta.Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca i campi del criterio del ciclo di vita nella risposta.Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca i campi del criterio del ciclo di vita nella risposta.Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca i campi del criterio del ciclo di vita nella risposta.PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca i campi del criterio del ciclo di vita nella risposta.Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca i campi del criterio del ciclo di vita nella risposta.Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per visualizzare i criteri del ciclo di vita del bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca i campi del criterio del ciclo di vita nella risposta.API REST
API JSON
- Ottieni un token di accesso all'autorizzazione da OAuth 2.0 Playground. Configura il parco giochi in modo che utilizzi le tue credenziali OAuth. Per le istruzioni, consulta la pagina relativa all'autenticazione API.
Utilizza
cURL
per chiamare l'API JSON con una richiesta diGET
bucket:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Dove:
OAUTH2_TOKEN
è il token di accesso che hai generato nel passaggio 1.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
- Ottieni un token di accesso all'autorizzazione da OAuth 2.0 Playground. Configura il parco giochi in modo che utilizzi le tue credenziali OAuth. Per le istruzioni, consulta la pagina relativa all'autenticazione API.
Utilizza
cURL
per chiamare l'API XML con una richiestaGET
di bucket:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
Dove:
OAUTH2_TOKEN
è il token di accesso che hai generato nel passaggio 1.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 e le condizioni del ciclo di vita disponibili.
- Scopri gli esempi di configurazione del ciclo di vita.