Utilizzare i bucket eliminati temporaneamente

Panoramica della funzionalità di eliminazione temporanea

Questa pagina descrive come elencare e ripristinare un bucket eliminato temporaneamente.

Panoramica

Dopo l'eliminazione temporanea di un bucket, questo viene conservato da Cloud Storage fino al momento dell'eliminazione definitiva e non può essere modificato mentre si trova in uno stato di eliminazione temporanea. La data/ora di eliminazione definitiva è almeno pari alla data/ora di eliminazione definitiva più recente degli oggetti del bucket. Trascorso il tempo di eliminazione definitiva, Cloud Storage elimina definitivamente il bucket. Quando ripristini un bucket eliminato temporaneamente, questo torna allo stato attivo e anche gli oggetti che si trovavano nel bucket al momento dell'eliminazione possono essere ripristinati.

Considerazioni

  • Per proteggere da eliminazioni dannose, un bucket eliminato temporaneamente non può essere eliminato definitivamente finché non è stato conservato per l'intera durata di conservazione dell'eliminazione temporanea.

  • Una volta che un bucket è stato eliminato temporaneamente, devi ripristinarlo prima di poter elencare o ripristinare gli oggetti eliminati temporaneamente al suo interno.

  • Per ripristinare un bucket eliminato temporaneamente, devi disporre del numero di generazione del bucket. Per recuperare il numero di generazione di un bucket eliminato temporaneamente, consulta Elenca i bucket eliminati temporaneamente.

  • Un bucket eliminato temporaneamente può essere ripristinato solo se non esiste un bucket attivo con lo stesso nome. Se tu o qualcun altro create un bucket con lo stesso nome di un bucket eliminato temporaneamente, non potete ripristinare il bucket eliminato temporaneamente finché il nuovo bucket non viene eliminato.

  • Le operazioni di ripristino del bucket non ripristinano gli oggetti eliminati temporaneamente che si trovavano nel bucket al momento dell'eliminazione. Per ripristinare gli oggetti eliminati temporaneamente dopo il ripristino del bucket eliminato temporaneamente, devi eseguire un'operazione di ripristino dell'oggetto.

  • I binding dei tag potrebbero non essere recuperati quando ripristini un bucket eliminato temporaneamente con i tag. Per evitare perdite di dati, quando ripristini un bucket eliminato temporaneamente con associazione di tag, ti consigliamo di verificare che le associazioni di tag del bucket siano state recuperate. Se i binding dei tag del bucket non sono stati recuperati, dovrai associare manualmente i tag non recuperati al bucket.

Autorizzazioni obbligatorie

Per ottenere le autorizzazioni necessarie per ripristinare i bucket eliminati temporaneamente, chiedi all'amministratore di concederti il ruolo IAM Storage Admin (roles/storage.admin) nel progetto Cloud Storage.

Questo ruolo predefinito contiene le autorizzazioni necessarie per ripristinare i bucket eliminati temporaneamente. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per ripristinare i bucket eliminati temporaneamente sono necessarie le seguenti autorizzazioni:

  • storage.buckets.list
  • storage.buckets.restore

Elenca i bucket eliminati temporaneamente

Puoi eseguire operazioni di elenco per recuperare i metadati dei bucket eliminati temporaneamente.

Utilizza le seguenti istruzioni per elencare tutti i bucket eliminati temporaneamente nel tuo progetto:

Riga di comando

Per elencare tutti i bucket eliminati temporaneamente, utilizza il comando gcloud storage ls:

gcloud storage ls --buckets --soft-deleted --full

API REST

API JSON

  1. Avere la gcloud CLI installata e inizializzata, 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?softDeleted=true"

Ripristinare un bucket eliminato temporaneamente

Segui queste istruzioni per ripristinare un bucket eliminato temporaneamente:

Riga di comando

Per ripristinare un bucket eliminato temporaneamente, utilizza il comando gcloud storage restore:

  gcloud storage restore gs://BUCKET_NAME#GENERATION_NUMBER

Sostituisci quanto segue:

  • BUCKET_NAME: il nome del bucket eliminato temporaneamente che vuoi ripristinare.

  • GENERATION_NUMBER: il numero di generazione permanente e univoco del bucket eliminato temporaneamente che vuoi ripristinare. Per ottenere il numero di generazione del bucket, consulta Elenco dei bucket eliminati temporaneamente.

API REST

API JSON

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

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

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

    Dove:

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

    • GENERATION_NUMBER è il numero di generazione univoco e permanente del bucket eliminato temporaneamente che vuoi ripristinare. Per ottenere il numero di generazione del bucket, consulta Elenco dei bucket eliminati temporaneamente.

Cloud Storage ripristina il bucket eliminato temporaneamente a uno stato attivo. Tieni presente che il ripristino del bucket non ripristina gli oggetti che si trovavano nel bucket al momento dell'eliminazione temporanea. Per ripristinare gli oggetti eliminati temporaneamente che si trovavano nel bucket al momento dell'eliminazione, consulta Ripristinare un oggetto eliminato temporaneamente.

Passaggi successivi