Utilizzare i bucket eliminati temporaneamente

Panoramica della funzionalità di eliminazione temporanea

Questa pagina descrive come elencare e ripristinare i bucket eliminati temporaneamente.

Panoramica

Dopo l'eliminazione temporanea, un bucket 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. Il tempo di eliminazione definitiva è almeno pari al tempo 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 proteggersi dall'eliminazione dannosa, un bucket eliminato temporaneamente non può essere eliminato definitivamente finché non è stato conservato per l'intera durata della conservazione dell'eliminazione temporanea.

  • Dopo l'eliminazione temporanea di un bucket, devi ripristinarlo prima di poter elencare o ripristinare gli oggetti eliminati temporaneamente al suo interno.

  • Per ripristinare un bucket eliminato temporaneamente, devi avere il 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 un'altra persona create un bucket con lo stesso nome di un bucket eliminato temporaneamente, non potrai ripristinare il bucket eliminato temporaneamente finché non verrà eliminato il nuovo bucket.

  • Quando ripristini un bucket eliminato temporaneamente utilizzando gcloud CLI o l'API JSON, gli oggetti nel bucket non vengono ripristinati. Per ripristinare gli oggetti eliminati temporaneamente, dovrai eseguire un'operazione di ripristino degli oggetti dopo aver ripristinato il bucket eliminato temporaneamente.

  • Le associazioni dei tag potrebbero non essere recuperate quando ripristini un bucket con tag eliminato temporaneamente. Per evitare la perdita di dati, quando ripristini un bucket eliminato temporaneamente 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 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
  • Ripristina gli oggetti quando utilizzi la console Google Cloud per ripristinare un bucket eliminato temporaneamente:
    • storage.objects.restore
    • storage.objects.create

Elenca i bucket eliminati temporaneamente

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

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

Console

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

    Vai a Bucket

  2. Fai clic su Visualizza opzioni.

  3. Seleziona Solo bucket eliminati temporaneamente.

  4. Fai clic su Salva.

    Viene visualizzato un elenco di bucket eliminati temporaneamente. Se un bucket eliminato temporaneamente ha più generazioni, ogni generazione del bucket viene visualizzata in una riga separata.

Riga di comando

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

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

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 Buckets: list che utilizza il parametro di query softDeleted:

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b?project=PROJECT_IDENTIFIER&softDeleted=true"

    Sostituisci PROJECT_IDENTIFIER con l'ID o il numero del progetto contenente i bucket eliminati temporaneamente che vuoi elencare.

Ripristina un bucket eliminato temporaneamente

Utilizza le seguenti istruzioni per ripristinare un bucket eliminato temporaneamente.

Quando ripristini un bucket eliminato temporaneamente utilizzando la console Google Cloud , puoi anche ripristinare gli oggetti eliminati temporaneamente che si trovavano nel bucket.

Console

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

    Vai a Bucket

  2. Visualizza i bucket eliminati temporaneamente nell'elenco dei bucket, se non sono già presenti. Per la procedura, consulta Elenca i bucket eliminati temporaneamente.

  3. Nella riga del bucket che vuoi ripristinare, fai clic su Ripristina.

  4. Se il bucket ha più generazioni, nella scheda Specifica la generazione del bucket, seleziona la generazione da ripristinare.

  5. Fai clic sulla scheda Specifica gli oggetti da ripristinare.

  6. Nella sezione Specifica gli oggetti da ripristinare, seleziona se vuoi ripristinare gli oggetti eliminati temporaneamente che si trovavano nel bucket. Sono disponibili le seguenti opzioni:

    • Non ripristinare gli oggetti.

      Se necessario, puoi ripristinare gli oggetti eliminati temporaneamente in un secondo momento.

    • Ripristina tutti gli oggetti.

    • Ripristina gli oggetti che corrispondono ai criteri. Segui questi passaggi:

      1. Seleziona l'intervallo di tempo da cui vuoi ripristinare gli oggetti.

      2. (Facoltativo) Per ripristinare solo gli oggetti che corrispondono a un pattern glob, seleziona Filtra per pattern glob e inserisci un pattern glob.

  7. (Facoltativo) Specifica altri comportamenti di ripristino nella sezione Opzioni aggiuntive.

  8. Fai clic su Ripristina.

    Cloud Storage ripristina lo stato attivo del bucket eliminato temporaneamente.

    Se ripristini gli oggetti nel bucket, Cloud Storage crea un'operazione di ripristino collettivo per gli oggetti. L'operazione viene eseguita in modo asincrono e l'avvio potrebbe richiedere un'ora o più. Puoi monitorare l'avanzamento dell'operazione facendo clic sul pulsante Notifiche () nell'intestazione della console Google Cloud . In alternativa, puoi utilizzare gcloud CLI per monitorare lo stato dell'operazione a lunga esecuzione associata.

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

Cloud Storage ripristina il bucket eliminato temporaneamente in uno stato attivo. Tieni presente che il ripristino del bucket non comporta il ripristino degli oggetti che si trovavano al suo interno. Per ripristinare gli oggetti eliminati temporaneamente, consulta Ripristina un oggetto eliminato temporaneamente.

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 Buckets: restore:

    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 Elenca i bucket eliminati temporaneamente.

    Cloud Storage ripristina lo stato attivo del bucket eliminato temporaneamente. Tieni presente che il ripristino del bucket non comporta il ripristino degli oggetti che si trovavano nel bucket. Per ripristinare gli oggetti eliminati temporaneamente, consulta Ripristina un oggetto eliminato temporaneamente.

Passaggi successivi