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

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

  • 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, devi eseguire un'operazione di ripristino degli oggetti dopo aver ripristinato il bucket eliminato temporaneamente.

  • 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
  • Ripristina gli oggetti quando utilizzi la console Cloud de Confiance 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 Cloud de Confiance , 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 installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. Utilizza cURL per chiamare l'API JSON con una richiesta di GETbucket:

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

Ripristinare un bucket eliminato temporaneamente

Segui queste istruzioni per ripristinare un bucket eliminato temporaneamente.

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

Console

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

    Vai a Bucket

  2. Visualizza i bucket eliminati temporaneamente nell'elenco dei bucket, se non sono già visualizzati. Per la procedura, vedi Elencare 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 generazione 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 comportamenti di ripristino aggiuntivi nella sezione Opzioni aggiuntive.

  8. Fai clic su Ripristina.

    Cloud Storage ripristina il bucket eliminato temporaneamente a uno stato attivo.

    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 potrebbe richiedere un'ora o più per iniziare. Puoi monitorare l'avanzamento dell'operazione facendo clic sul pulsante Notifiche () nell'intestazione della console Cloud de Confiance . In alternativa, puoi utilizzare gcloud CLI per monitorare lo stato dell'operazione di lunga durata 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 permanente e univoco 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 comporta il ripristino degli oggetti che si trovavano al suo interno. Per ripristinare gli oggetti eliminati temporaneamente, consulta Ripristinare un oggetto eliminato temporaneamente.

API REST

API JSON

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

  2. Utilizza cURL per chiamare l'API JSON con una richiesta di POSTbucket:

    curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.s3nsapis.fr/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 comporta il ripristino degli oggetti che si trovavano al suo interno. Per ripristinare gli oggetti eliminati temporaneamente, consulta Ripristinare un oggetto eliminato temporaneamente.

Passaggi successivi