Utilizzare l'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 archiviazione (roles/storage.admin) nel bucket o nel progetto che contiene il bucket.

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 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.

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 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 gestire il criterio di eliminazione soft.

  3. Fai clic sulla scheda Protezione.

  4. Nella sezione Criteri di eliminazione temporanea, esegui una delle seguenti azioni:

    • Se il bucket non ha un criterio di eliminazione temporanea, fai clic su Modifica, scegli un'unità di tempo e una durata per la durata di conservazione e fai clic su Salva.

    • Se il bucket ha un criterio di eliminazione temporanea, fai clic su Modifica per cambiare l'unità di tempo e la durata della conservazione.

Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud, consulta la sezione 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 per conservare gli oggetti eliminati temporaneamente. Ad esempio, 2w1d corrisponde a due settimane e un giorno. Per ulteriori informazioni, consulta la sezione sulla durata di conservazione dell'eliminazione soft.

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 indica il periodo di tempo in secondi per cui vuoi conservare gli oggetti eliminati temporaneamente. Ad esempio, 2678400. Per ulteriori informazioni, consulta la sezione sulla durata di conservazione dell'eliminazione soft.

  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 il criterio di eliminazione temporanea è attivo in 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 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 console Google Cloud, consulta la sezione 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