Impostare e gestire i criteri di eliminazione temporanea

Panoramica Utilizzo

Questa pagina descrive come impostare e gestire le policy di eliminazione temporanea. Puoi impostare nuovi criteri sui bucket per abilitare l'eliminazione temporanea, nonché aggiornare e controllare lo stato dei criteri esistenti. Per scoprire come disattivare l'eliminazione temporanea, consulta Disattivare l'eliminazione temporanea.

Per scoprire come elencare e ripristinare gli oggetti eliminati temporaneamente, consulta Utilizzare gli oggetti eliminati temporaneamente. Per scoprire come elencare e ripristinare i bucket eliminati temporaneamente, consulta Utilizzare i bucket eliminati temporaneamente.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per attivare e gestire le norme di eliminazione temporanea, chiedi all'amministratore di concederti il ruolo IAM Storage Admin (roles/storage.admin) nel bucket o nel progetto che contiene il bucket.

Questo ruolo predefinito contiene le autorizzazioni necessarie per abilitare e gestire le norme di eliminazione temporanea. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per attivare e gestire i criteri di eliminazione temporanea sono necessarie le seguenti autorizzazioni:

• storage.buckets.get
• storage.buckets.update
• storage.buckets.list (questa autorizzazione è necessaria solo se prevedi di utilizzare la console Google Cloud per eseguire le istruzioni riportate in questa pagina)

Per informazioni sulla concessione dei ruoli, consulta Utilizzare IAM con i bucket o Gestire l'accesso ai progetti.

Modifica la policy di eliminazione temporanea di un bucket

La nuova durata del periodo di conservazione dell'eliminazione temporanea si applica solo agli oggetti o ai bucket che elimini dopo l'entrata in vigore del criterio di eliminazione temporanea. Gli oggetti eliminati temporaneamente esistenti non sono interessati dagli aggiornamenti apportati al criterio di eliminazione temporanea e vengono conservati per la durata in vigore al momento dell'eliminazione.

Segui queste istruzioni per modificare la policy di eliminazione temporanea di un bucket:

Console

1. Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
   

   Vai a Bucket

2. Nell'elenco dei bucket, fai clic sul nome del bucket di cui vuoi modificare la norma di eliminazione temporanea.

3. Fai clic sulla scheda Protezione.

4. Nella sezione Policy di eliminazione temporanea (per il recupero dei dati), aggiungi una nuova policy di eliminazione temporanea o modifica la durata della conservazione di una policy esistente seguendo questi passaggi:

   1. Fai clic su Modifica.

   2. Nella finestra di dialogo Imposta una policy di eliminazione temporanea visualizzata, specifica una durata di conservazione per l'eliminazione temporanea scegliendo un'unità di tempo e una durata.

   3. Fai clic su Salva.

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

Per aggiungere o modificare la policy di eliminazione temporanea di un bucket, utilizza il comando gcloud storage buckets update con il flag --soft-delete-duration:

  gcloud storage buckets update gs://BUCKET_NAME --soft-delete-duration=SOFT_DELETE_DURATION

Dove:

• BUCKET_NAME è il nome del bucket. Ad esempio, my-bucket.

• SOFT_DELETE_DURATION specifica la durata di conservazione dell'eliminazione temporanea.

  • L'unità s rappresenta i secondi.
  • L'unità d rappresenta i giorni.
  • L'unità m rappresenta i mesi.

  Ad esempio:

  • 7d43200s imposta una durata di conservazione di sette giorni e mezzo (7 giorni e 43.200 secondi).

  • 2w1d imposta una durata di conservazione di due settimane e un giorno.

API REST

API JSON

1. Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione Authorization.

2. Crea un file JSON contenente le seguenti informazioni:

   {
     "softDeletePolicy": {
       "retentionDurationSeconds": "TIME_IN_SECONDS"
     }
   }

   Dove TIME_IN_SECONDS è la quantità di tempo in secondi per cui vuoi impostare la durata di conservazione dell'eliminazione temporanea. Ad esempio, 2678400 per 2.678.400 secondi (31 giorni).

3. Utilizza cURL per chiamare l'API JSON con una richiesta PATCH 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"

   Dove:

   • JSON_FILE_NAME è il percorso del file JSON che hai creato nel passaggio 2.
   • BUCKET_NAME è il nome del bucket pertinente. Ad esempio, my-bucket.

Controllare se la policy di eliminazione temporanea è attivata per un bucket

Console

1. Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
   

   Vai a Bucket

2. Nell'elenco dei bucket, fai clic sul nome del bucket di cui vuoi controllare il criterio di eliminazione temporanea.

3. Fai clic sulla scheda Protezione.

   Lo stato viene visualizzato nella sezione Criterio di eliminazione temporanea (per il recupero dei dati).

Puoi anche utilizzare la scheda Protezione per verificare se esiste una normativa di eliminazione temporanea nel tuo bucket.

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

Per controllare lo stato della policy di eliminazione temporanea di un bucket, utilizza il comando gcloud storage buckets describe:

  gcloud storage buckets describe gs://BUCKET_NAME \
      --format="default(soft_delete_policy)"

Dove:

• BUCKET_NAME è il nome del bucket. Ad esempio, my-bucket.

API REST

API JSON

1. Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione Authorization.

2. Utilizza cURL per chiamare l'API JSON con una richiesta di GETbucket:

   curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=softDeletePolicy"

   Dove BUCKET_NAME è il nome del bucket pertinente. Ad esempio, my-bucket.

Passaggi successivi

• Scopri come utilizzare gli oggetti eliminati temporaneamente.
• Scopri come utilizzare i bucket eliminati temporaneamente.
• Scopri come disattivare l'eliminazione temporanea.