Utilizzare i bucket eliminati temporaneamente

Panoramica della funzionalità di eliminazione temporanea

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

Panoramica

Dopo l'eliminazione temporanea, un bucket viene conservato da Cloud Storage per la durata della conservazione dell'eliminazione temporanea e non può essere modificato mentre è in stato di eliminazione temporanea. Al termine della durata di conservazione dell'eliminazione temporanea, Cloud Storage elimina definitivamente il bucket e i relativi oggetti. I bucket con la funzionalità di eliminazione temporanea attivata al momento dell'eliminazione possono essere ripristinati entro la durata della conservazione dell'eliminazione temporanea. Quando ripristini un bucket eliminato temporaneamente, questo viene riportato allo stato attivo ed è possibile ripristinare anche gli oggetti che si trovavano nel bucket al momento dell'eliminazione.

Considerazioni

  • Per ripristinare un bucket eliminato definitivamente, 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.

  • 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 degli oggetti.

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

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

  • 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 definitivamente, non potete ripristinare il bucket eliminato definitivamente finché non viene eliminato il nuovo bucket.

  • Non puoi ripristinare i bucket eliminati temporaneamente con lo spazio dei nomi gerarchico abilitato.

  • Le associazioni di tag potrebbero non essere recuperate quando ripristini un bucket eliminato temporaneamente con tag. Per evitare la perdita di dati, quando ripristini un bucket eliminato con eliminazione soft con associazioni di tag, ti consigliamo di verificare che le associazioni di tag del bucket siano state recuperate. Se le associazioni dei tag del bucket non sono state recuperate, dovrai associare manualmente i tag non recuperati al bucket.

Autorizzazioni obbligatorie

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

Questo ruolo predefinito contiene le autorizzazioni necessarie per ripristinare i bucket eliminati definitivamente. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per ripristinare i bucket eliminati definitivamente 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 definitivamente.

Segui queste istruzioni per elencare tutti i bucket eliminati definitivamente nel tuo progetto:

Riga di comando

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

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

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?softDeleted=true"

Ripristinare un bucket eliminato temporaneamente

Segui le istruzioni riportate di seguito per ripristinare un bucket eliminato definitivamente:

Riga di comando

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

     gcloud storage restore gs://BUCKET_NAME#GENERATION_NUMBER

Sostituisci quanto segue:

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

  • GENERATION_NUMBER: il numero di generazione permanente e univoco del bucket eliminato definitivamente che vuoi ripristinare. Per ottenere il numero di generazione del bucket, consulta Elenca i bucket eliminati definitivamente.

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 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 unico e permanente del bucket eliminato definitivamente che vuoi ripristinare. Per ottenere il numero di generazione del bucket, consulta Elenca i bucket eliminati definitivamente.

Cloud Storage ripristina il bucket eliminato definitivamente in uno stato attivo. Tieni presente che il ripristino del bucket non ripristina gli oggetti presenti 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