In questa pagina viene descritto come utilizzare la funzionalità di blocco della conservazione degli oggetti, compresa l'abilitazione per un bucket e l'impostazione delle configurazioni di conservazione per gli oggetti all'interno del bucket.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per abilitare la funzionalità di blocco della conservazione degli oggetti per un bucket e impostare le configurazioni di conservazione degli oggetti, chiedi all'amministratore di concederti il ruolo IAM Amministratore Storage (roles/storage.admin
) nel bucket o nel progetto che contiene il bucket. Questo ruolo predefinito contiene le autorizzazioni necessarie per impostare e gestire le configurazioni della conservazione. Per visualizzare esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.create
storage.buckets.enableObjectRetention
storage.buckets.get
storage.buckets.list
- Questa autorizzazione è richiesta solo se prevedi di utilizzare la console Google Cloud per eseguire le istruzioni in questa pagina.
storage.objects.get
storage.objects.list
- Questa autorizzazione è richiesta solo se prevedi di utilizzare la console Google Cloud per eseguire le istruzioni in questa pagina.
storage.objects.overrideUnlockedRetention
- Questa autorizzazione è necessaria solo se prevedi di bloccare o abbreviare una configurazione di conservazione esistente.
storage.objects.setRetention
storage.objects.update
Potresti anche riuscire a ottenere queste autorizzazioni con i ruoli personalizzati.
Per informazioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket. Per informazioni sulla concessione dei ruoli nei progetti, consulta Gestire l'accesso ai progetti.
Abilita le conservazioni degli oggetti per un bucket
L'abilitazione delle conservazioni degli oggetti è supportata solo durante la creazione del bucket e, se la conservazione degli oggetti è abilitata in un bucket, non può essere disabilitata. Utilizza le seguenti istruzioni per abilitare le conservazioni degli oggetti per un bucket:
Console
Crea un bucket come faresti normalmente e, nel passaggio Scegli come proteggere i dati degli oggetti, seleziona Conservazione (per la conformità) e poi Abilita conservazione degli oggetti.
Riga di comando
Crea un bucket come faresti normalmente e includi il flag --enable-per-object-retention
nel comando.
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
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.
C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
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.
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
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.
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
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 la documentazione di riferimento dell'API PHP di Cloud Storage.
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 Python di Cloud Storage.
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.
API REST
API JSON
Crea un bucket come faresti normalmente e includi il parametro di query enableObjectRetention=true
nella richiesta.
API XML
Crea un bucket come faresti normalmente e includi l'intestazione
x-goog-bucket-object-lock-enabled: True
nella richiesta.
Visualizzare lo stato di conservazione degli oggetti di un bucket
Per verificare se le conservazioni degli oggetti sono abilitate per un 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 Protezione.
Lo stato di conservazione degli oggetti del bucket viene visualizzato nella sezione Conservazione degli oggetti.
Riga di comando
Utilizza il comando gcloud storage buckets describe
con il
flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(per_object_retention)"
Dove BUCKET_NAME
è il nome del bucket
di cui vuoi visualizzare il criterio di conservazione. Ad esempio, my-bucket
.
Se l'operazione ha esito positivo ed esiste un criterio di conservazione per il bucket, la risposta è simile alla seguente:
per_object_retention: mode: Enabled
Se l'operazione ha esito positivo e non esiste un criterio di conservazione per il bucket, la risposta è simile alla seguente:
null
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione degli oggetti di un bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca il campo di conservazione degli oggetti nella risposta.C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione degli oggetti di un bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca il campo di conservazione degli oggetti nella risposta.Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione degli oggetti di un bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca il campo di conservazione degli oggetti nella risposta.Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione degli oggetti di un bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca il campo di conservazione degli oggetti nella risposta.PHP
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione degli oggetti di un bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca il campo di conservazione degli oggetti nella risposta.Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione degli oggetti di un bucket, segui le istruzioni per visualizzare i metadati del bucket e cerca il campo di conservazione degli oggetti nella risposta.API REST
API JSON
Installa e inizializzatogcloud CLI per 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
.Usa
cURL
per chiamare l'API JSON con una richiesta BucketGET
che include il campoobjectRetention
:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=objectRetention"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
Installa e inizializzatogcloud CLI per 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 richiestaGET
Bucket nell'ambito di?object-lock
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?object-lock"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Imposta la configurazione di conservazione di un oggetto
Per impostare una configurazione di conservazione per un oggetto, quest'ultimo deve essere archiviato in un bucket per il quale sono abilitate le conservazioni degli oggetti. Per impostare una configurazione di conservazione per un oggetto:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene l'oggetto di cui vuoi impostare o modificare la configurazione di conservazione.
Si apre la pagina Dettagli bucket, con la scheda Oggetti selezionata.
Accedi all'oggetto, che potrebbe trovarsi in una cartella.
Fai clic sul nome dell'oggetto.
Si apre la pagina Dettagli oggetto, che mostra i metadati dell'oggetto.
Nella sezione Protezione, fai clic sull'icona Modifica (edit) associata a Dalla configurazione della conservazione degli oggetti.
Si apre il riquadro Modifica conservazione.
Nella sezione Configurazione della conservazione degli oggetti, fai clic su Abilitata o Disabilitata.
- Se la configurazione della conservazione è abilitata, seleziona una data e un'ora per la configurazione nella sezione Conserva fino a e fai clic su Sbloccato o Bloccato nella sezione Modalità di conservazione.
Fai clic su Conferma.
Riga di comando
Utilizza il comando gcloud storage objects update
con i
flag appropriati. Per aggiungere o modificare una configurazione di conservazione, utilizza il comando seguente. Tieni presente che devi includere anche il flag --override-unlocked-retention
se stai modificando una configurazione esistente in modo da bloccarla o ridurne la durata:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME --retain-until=DATETIME --retention-mode=STATE
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto rilevante. Ad esempio,kitten.png
.DATETIME
indica la prima data e ora in cui l'oggetto può essere eliminato. Ad esempio,2028-02-15T05:30:00Z
.STATE
èLocked
oUnlocked
.
Se l'esito è positivo, la risposta è simile al seguente esempio:
Updating gs://my-bucket/kitten.png... Completed 1
Per rimuovere una configurazione di conservazione da un oggetto, utilizza il seguente comando:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME --clear-retention --override-unlocked-retention
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto rilevante. Ad esempio,kitten.png
.
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
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.
C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
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.
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
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.
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
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 la documentazione di riferimento dell'API PHP di Cloud Storage.
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 Python di Cloud Storage.
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.
API REST
API JSON
Installa e inizializzatogcloud CLI per 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 contenente le seguenti informazioni:
{ "retention": { "mode": STATE, "retainUntilTime": "DATETIME" } }
Dove:
STATE
èLocked
oUnlocked
.DATETIME
è la prima data e ora in cui l'oggetto può essere eliminato. Ad esempio,2028-02-15T05:30:00Z
.
Usa
cURL
per chiamare l'API JSON con una richiesta OggettoPATCH
: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/o/OBJECT_NAME?overrideUnlockedRetention=BOOLEAN"
Dove:
JSON_FILE_NAME
è il percorso del file creato al passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.OBJECT_NAME
è il nome codificato nell'URL dell'oggetto pertinente. Ad esempio,pets/kitten.png
, con codifica URLpets%2Fkitten.png
.BOOLEAN
deve esseretrue
se la richiesta accorcia, rimuove o blocca una configurazione di conservazione esistente. In caso contrario, il parametrooverrideUnlockedRetention
può essere escluso completamente dalla richiesta.
API XML
Installa e inizializzatogcloud CLI per 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 che contenga le seguenti informazioni:
<Retention> <Mode> STATE </Mode> <RetainUntilDate> DATETIME </RetainUntilDate> </Retention>
Dove:
STATE
èGOVERNANCE
oCOMPLIANCE
.DATETIME
è la prima data e ora in cui l'oggetto può essere eliminato. Ad esempio,2028-02-15T05:30:00Z
.
Utilizza
cURL
per chiamare l'API XML con una richiesta OggettoPUT
nell'ambito di?retention
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-bypass-governance-retention: BOOLEAN" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME?retention"
Dove:
XML_FILE_NAME
è il percorso del file XML creato al passaggio 2.BOOLEAN
deve esseretrue
se la richiesta accorcia, rimuove o blocca una configurazione di conservazione esistente. In caso contrario, l'intestazionex-goog-bypass-governance-retention
può essere esclusa completamente dalla richiesta.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.OBJECT_NAME
è il nome codificato nell'URL dell'oggetto pertinente. Ad esempio,pets/kitten.png
, con codifica URLpets%2Fkitten.png
.
Visualizza la configurazione di conservazione di un oggetto
Per visualizzare l'eventuale configurazione della conservazione che è stata impostata su un oggetto:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene l'oggetto di cui vuoi visualizzare la configurazione di conservazione.
Si apre la pagina Dettagli bucket, con la scheda Oggetti selezionata.
Accedi all'oggetto, che potrebbe trovarsi in una cartella.
Fai clic sul nome dell'oggetto.
Si apre la pagina Dettagli oggetto, che mostra i metadati dell'oggetto. Le informazioni sulla configurazione della conservazione dell'oggetto vengono mostrate nella sezione Protezione.
Riga di comando
Utilizza il comando gcloud storage objects describe
con il
flag --format
:
gcloud storage objects describe gs://BUCKET_NAME/OBJECT_NAME --format="default(retention_settings)"
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto rilevante. Ad esempio,kitten.png
.
Se l'operazione ha esito positivo ed esiste una configurazione di conservazione per l'oggetto, la risposta è simile alla seguente:
retention_settings: mode: Unlocked retainUntilTime: '2028-11-30T14:11:14+00:00'
In caso di esito positivo e non esiste una configurazione di conservazione per l'oggetto, la risposta è simile alla seguente:
null
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione di un oggetto, segui le istruzioni per visualizzare i metadati dell'oggetto e cerca il campo di conservazione nella risposta.C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione di un oggetto, segui le istruzioni per visualizzare i metadati dell'oggetto e cerca il campo di conservazione nella risposta.Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione di un oggetto, segui le istruzioni per visualizzare i metadati dell'oggetto e cerca il campo di conservazione nella risposta.Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione di un oggetto, segui le istruzioni per visualizzare i metadati dell'oggetto e cerca il campo di conservazione nella risposta.PHP
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione di un oggetto, segui le istruzioni per visualizzare i metadati dell'oggetto e cerca il campo di conservazione nella risposta.Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
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.
Per visualizzare la configurazione della conservazione di un oggetto, segui le istruzioni per visualizzare i metadati dell'oggetto e cerca il campo di conservazione nella risposta.API REST
API JSON
Installa e inizializzatogcloud CLI per 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
.Usa
cURL
per chiamare l'API JSON con una richiesta OggettoGET
che include il camporetention
:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/OBJECT_NAME?fields=retention"
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto rilevante. Ad esempio,kitten.png
.
API XML
Installa e inizializzatogcloud CLI per 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 OggettoGET
nell'ambito di?retention
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME?retention"
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto rilevante. Ad esempio,kitten.png
.
Passaggi successivi
- Scopri di più sulle configurazioni di conservazione.
- Scopri altre funzionalità che proteggono i tuoi dati di Cloud Storage.
- Scopri di più sulla Gestione del ciclo di vita degli oggetti, che può eliminare automaticamente i file una volta raggiunto il periodo di conservazione.