Impostare e gestire i criteri di eliminazione temporanea

Panoramica Utilizzo

Questa pagina descrive come attivare, aggiornare e controllare lo stato del criterio di eliminazione soft in un bucket. Per scoprire come elencare e ripristinare gli oggetti con eliminazione temporanea, consulta Utilizzare gli oggetti con eliminazione temporanea. Per elencare e ripristinare i bucket eliminati temporaneamente, consulta Utilizzare i bucket eliminati temporaneamente. Per ulteriori informazioni sull'eliminazione soft, consulta la sezione Panoramica. Per disattivare la funzionalità, consulta Disattivare l'eliminazione temporanea.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per attivare e gestire i criteri di eliminazione soft, chiedi all'amministratore di concederti il ruolo IAM Amministratore dello spazio di archiviazione (roles/storage.admin) per il bucket o il progetto che lo contiene.

Questo ruolo predefinito contiene le autorizzazioni necessarie per attivare e gestire i criteri di eliminazione temporanea. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

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

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

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

Modificare il criterio di eliminazione temporanea di un bucket

La nuova durata di conservazione per l'eliminazione temporanea si applica solo agli oggetti o ai bucket eliminati dopo l'applicazione 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 le istruzioni riportate di seguito per modificare il criterio di eliminazione temporanea di un bucket:

Console

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

    Vai a Bucket

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

  3. Fai clic sulla scheda Protezione.

  4. Nella sezione Criterio di eliminazione temporanea (per il recupero dei dati), aggiungi un nuovo criterio di eliminazione temporanea o modifica la durata della conservazione di un criterio 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 misura 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 Google Cloud console, consulta Risoluzione dei problemi.

Riga di comando

Per aggiungere o modificare il criterio di eliminazione 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 installato e inizializzatogcloud CLI, che 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 è il periodo di tempo in secondi per il quale 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.

Verificare se il criterio di eliminazione temporanea è attivo in un bucket

Console

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

    Vai a Bucket

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

  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 nel tuo bucket è presente un criterio di eliminazione soft.

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 del criterio 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 installato e inizializzatogcloud CLI, che 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