Impostare e gestire i criteri di eliminazione temporanea

Panoramica sull'utilizzo

Questa pagina descrive come impostare e gestire le policy di eliminazione temporanea. Puoi impostare nuove policy sui bucket per abilitare l'eliminazione temporanea, nonché aggiornare e controllare lo stato delle policy 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 abilitare e gestire le policy 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 policy di eliminazione temporanea. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per abilitare e gestire le policy di eliminazione temporanea sono richieste le seguenti autorizzazioni:

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

Per informazioni sulla concessione dei ruoli, consulta Impostare e gestire le policy IAM sui bucket o Gestire l'accesso ai progetti.

Modificare la policy di eliminazione temporanea di un bucket

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

Utilizza le seguenti istruzioni per modificare la policy di eliminazione temporanea di un bucket:

Console

  1. Nella Google Cloud console, 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 policy 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 di 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 dell'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 Google Cloud console, consulta Risoluzione dei problemi.

Riga di comando

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

  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. Assicurati che gcloud CLI sia installato e inizializzato, in modo da poter 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 a. Ad esempio, 2678400 per 2.678.400 secondi (31 giorni).

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

Verificare se la policy di eliminazione temporanea è abilitata su un bucket

Console

  1. Nella Google Cloud console, 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 la policy di eliminazione temporanea.

  3. Fai clic sulla scheda Protezione.

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

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

Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella Google Cloud console, consulta Risoluzione dei problemi.

Riga di comando

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

  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. Assicurati che gcloud CLI sia installato e inizializzato, in modo da poter generare un token di accesso per l'intestazione Authorization.

  2. Utilizza cURL per chiamare l'API JSON con una GET Bucket richiesta:

    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