Impostare e gestire i criteri di eliminazione temporanea

Panoramica Utilizzo

In questa pagina viene descritto come impostare e gestire le policy di eliminazione temporanea. Puoi impostare nuove policy sui bucket per attivare l'eliminazione temporanea, nonché aggiornare e controllare lo stato delle policy esistenti. Per scoprire come disattivare l'eliminazione temporanea, consulta Disattiva l'eliminazione temporanea.

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per attivare e gestire le policy di eliminazione temporanea, chiedi all'amministratore di concederti il ruolo IAM Storage Admin (roles/storage.admin) sul bucket o sul 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 attivare e gestire le politiche di cancellazione 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 Imposta e gestisci le policy IAM sui bucket o Gestisci l'accesso ai progetti.

Modifica la politica di cancellazione temporanea di un bucket

La nuova durata di conservazione per l'eliminazione temporanea si applica solo agli oggetti o ai bucket che elimini dopo l'entrata in vigore della politica di cancellazione temporanea. Gli oggetti eliminati temporaneamente esistenti non sono interessati dagli aggiornamenti apportati alla politica di cancellazione 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 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 politica di cancellazione 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 per l'eliminazione temporanea scegliendo un'unità di tempo e un periodo di tempo.

    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 politica di cancellazione temporanea in 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 installato e inizializzato, che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. Crea un file JSON che contenga le seguenti informazioni:

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

    Dove TIME_IN_SECONDS è il periodo 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.

Controlla se la politica di cancellazione temporanea è abilitata su 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 la politica di cancellazione 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 nel bucket è presente una policy di eliminazione temporanea.

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 installato e inizializzato, che ti consente di generare un token di accesso per l'intestazione Authorization.

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

    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