Questa pagina descrive come elencare, accedere e ripristinare gli oggetti eliminati temporaneamente.
Prima di iniziare
Per completare le attività in questa pagina, assicurati di avere l'amministratore Storage
(roles/storage.admin
) ruolo IAM nel bucket o nel progetto
che contiene il bucket. Questo ruolo predefinito include le autorizzazioni
necessaria per gestire e ripristinare
l'eliminazione temporanea su un bucket.
Per vedere con esattezza le autorizzazioni necessarie, espandi la sezione Sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.update
storage.buckets.list
- Questa autorizzazione è necessaria se prevedi di utilizzare la console Google Cloud per eseguire le istruzioni in questa pagina.
storage.objects.restore
storage.objects.create
storage.objects.delete
- Questa autorizzazione è necessaria se il ripristino di un oggetto comporta la sovrascrittura di un oggetto esistente.
storage.buckets.restore
- Questa autorizzazione è necessaria se vuoi ripristinare collettivamente gli oggetti eliminati temporaneamente in un bucket.
storage.bucketOperations.*
- Questa autorizzazione è richiesta per le operazioni a lunga esecuzione.
Per informazioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket. Per informazioni sulla concessione dei ruoli nei progetti, consulta Gestire l'accesso ai progetti.
Elenca tutti gli oggetti eliminati temporaneamente in un bucket
Puoi elencare tutti gli oggetti eliminati temporaneamente in un bucket.
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che vuoi visualizzare degli oggetti eliminati temporaneamente. Si apre la pagina Dettagli bucket con la scheda Oggetti selezionata.
Nell'elenco Mostra, seleziona Solo oggetti eliminati temporaneamente. Viene visualizzato un elenco di oggetti eliminati temporaneamente.
Riga di comando
Per visualizzare un elenco di tutti gli oggetti eliminati temporaneamente in un bucket, utilizza il metodo
gcloud storage ls
con --soft-deleted
e
--recursive
flag:
gcloud storage ls gs://BUCKET_NAME --soft-deleted --recursive
Sostituisci quanto segue:
BUCKET_NAME
: il nome del bucket. Ad esempio,my-bucket
.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con un richiesta di elencare gli oggetti che utilizza la 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/BUCKET_NAME/o?softDeleted=true"
Dove
BUCKET_NAME
è il nome del del bucket pertinente. Ad esempio,my-bucket
.
Visualizza tutte le versioni eliminate temporaneamente di un oggetto
Puoi visualizzare tutte le versioni eliminate temporaneamente di un oggetto specifico nel tuo bucket.
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene dell'oggetto di cui vuoi visualizzare le versioni eliminate temporaneamente. Si apre la pagina Dettagli bucket con la scheda Oggetti selezionata.
Fai clic sull'oggetto di cui vuoi visualizzare tutte le versioni eliminate temporaneamente. Viene visualizzata la pagina Dettagli oggetto.
Fai clic sulla scheda Cronologia delle versioni.
Nell'elenco Mostra, seleziona Solo oggetti eliminati temporaneamente. Viene visualizzato un elenco di tutte le versioni eliminate temporaneamente per quell'oggetto.
Riga di comando
Per visualizzare un elenco di tutte le versioni eliminate temporaneamente di un oggetto in un
utilizzare il comando gcloud storage ls
:
gcloud storage ls gs://BUCKET_NAME/OBJECT_NAME --soft-deleted
Sostituisci quanto segue:
BUCKET_NAME
: il nome del bucket. Ad esempio,my-bucket
.OBJECT_NAME
: il nome dell'oggetto di cui vuoi visualizzare tutte le versioni.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con un richiesta di elencare gli oggetti che utilizza la query?softDeleted
:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o?matchGlob=OBJECT_NAME&softDeleted=true"
Sostituisci quanto segue:
BUCKET_NAME
: il nome del bucket. Ad esempio,my-bucket
.OBJECT_NAME
: il nome dell'oggetto per che vuoi visualizzare tutte le versioni.
Ripristina un oggetto eliminato temporaneamente
Puoi ripristinare una versione specifica di un oggetto eliminato temporaneamente di sincronizzare la directory di una VM con un bucket.
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene degli oggetti eliminati temporaneamente che vuoi ripristinare. Si apre la pagina Dettagli bucket con la scheda Oggetti selezionata.
Nell'elenco Mostra, seleziona Solo oggetti eliminati temporaneamente.
Accedi all'oggetto, che potrebbe trovarsi in una cartella.
Fai clic sull'oggetto eliminato temporaneamente. Viene visualizzata la pagina Dettagli oggetto.
Nell'elenco Mostra, seleziona Solo oggetti eliminati temporaneamente. Viene visualizzato un elenco di tutte le versioni eliminate temporaneamente di quell'oggetto.
Per ripristinare una specifica versione eliminata temporaneamente di un oggetto, fai clic su Ripristina accanto alla versione dell'oggetto. Si apre il riquadro di ripristino della versione dell'oggetto.
Fai clic su Conferma.
Riga di comando
Per ripristinare una versione eliminata temporaneamente di un oggetto, utilizza
Il comando gcloud storage restore
:
gcloud storage restore gs://BUCKET_NAME/OBJECT_NAME#GENERATION_NUMBER
Sostituisci quanto segue:
BUCKET_NAME
: il nome del bucket. Ad esempio,my-bucket
.OBJECT_NAME
: il nome dell'oggetto per il quale che vuoi visualizzare tutte le versioni.GENERATION_NUMBER
: il numero di generazione della eliminato temporaneamente che vuoi ripristinare. Se non specifichi numero di generazione, viene ripristinata l'ultima versione. Ad esempio,1560468815691234
.
Per ulteriori opzioni per il ripristino di più oggetti in blocco, tra cui
ripristinare tutte le versioni di un oggetto con il flag all-versions
, consulta
Riferimento gcloud storage restore
.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con un RichiestaPOST
oggetto: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/o/OBJECT_NAME/restore?generation=GENERATION_NUMBER"
Dove:
BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.OBJECT_NAME
è il nome del eliminato temporaneamente che vuoi ripristinare. Ad esempio,cat.jpeg
.GENERATION_NUMBER
è il numero di generazione dell'oggetto eliminato temporaneamente che vuoi ripristinare. In caso contrario specifichi il numero di generazione, viene ripristinata l'ultima versione. Ad esempio,1560468815691234
.
Ripristinare in blocco gli oggetti eliminati temporaneamente in un bucket
Se vuoi ripristinare un numero elevato di oggetti o non conosci lo specifico utilizzare un'operazione di ripristino collettivo. Tieni presente che le operazioni di ripristino avvengono in modo asincrono e possono, in alcuni casi, richiedere un'ora per iniziare.
L'operazione di ripristino collettivo avvia un'operazione a lunga esecuzione in un bucket. Puoi utilizzare Google Cloud CLI per recuperare ed elencare i pod operazioni per poter visualizzare i dettagli e lo stato del ripristino collettivo operativa mentre è in corso.
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, trova il bucket che contiene gli oggetti da ripristinare.
Fai clic sul menu overflow del bucket (more_vert) associati con il bucket e seleziona Crea job di ripristino.
Viene visualizzato il riquadro Crea un job di ripristino.
Nella sezione Scegli gli oggetti eliminati temporaneamente da ripristinare, seleziona il periodo di eliminazione a partire dal quale ripristinare gli oggetti.
(Facoltativo) Seleziona Filtra per pattern glob e inserisci un pattern glob per ripristinano solo gli oggetti che soddisfano i criteri del pattern glob.
(Facoltativo) Attiva/disattiva ulteriori comportamenti di ripristino nella Opzioni di ripristino.
Fai clic su Crea.
Puoi monitorare l'avanzamento dell'operazione di ripristino collettivo facendo clic sul Pulsante Notifiche (notifications) presente nell'intestazione della console Google Cloud.
Riga di comando
Per utilizzare l'operazione di ripristino collettivo per ripristinare tutti gli oggetti in un bucket, utilizza
Comando gcloud storage restore
.
Il seguente comando esegue l'operazione di ripristino collettivo in modo asincrono ripristinare tutti gli oggetti del bucket che sono stati eliminati durante un processo periodo di tempo:
gcloud storage restore gs://BUCKET_NAME/** \ --async --deleted-after-time=DELETED_AFTER_TIME \ --deleted-before-time=DELETED_BEFORE_TIME
Sostituisci quanto segue:
BUCKET_NAME
: il nome del bucket. Ad esempio,my-bucket
.DELETED_AFTER_TIME
: un argomento facoltativo per e specificare la data dopo la quale vengono ripristinati gli oggetti. Ad esempio:2022-12-01
.DELETED_BEFORE_TIME
: un argomento facoltativo per e specificare la data prima del quale vengono ripristinati gli oggetti. Ad esempio:2022-12-21
.In caso di esito positivo, il comando restituisce l'ID dell'operazione a lunga esecuzione associate all'operazione di ripristino collettivo. Puoi visualizzare i dettagli dell'operazione a lunga esecuzione o annullare l'operazione l'operazione di ripristino collettivo prima che venga completata. Per ulteriori informazioni, consulta Utilizzare operazioni a lunga esecuzione.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con un RichiestaPOST
oggetto: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/o/bulkRestore"
Dove
BUCKET_NAME
è il nome del del bucket pertinente. Ad esempio,my-bucket
.
In caso di esito positivo, il comando restituisce l'ID dell'operazione a lunga esecuzione associate all'operazione di ripristino collettivo. Puoi visualizzare i dettagli dell'operazione a lunga esecuzione o annullare l'operazione l'operazione di ripristino collettivo prima che venga completata. Per ulteriori informazioni informazioni, consulta Utilizzare operazioni a lunga esecuzione.
Utilizza le operazioni a lunga esecuzione per il ripristino collettivo
L'operazione di ripristino collettivo avvia un'operazione a lunga esecuzione. Puoi recuperare ed elencare le operazioni a lunga esecuzione per visualizzare i dettagli e stato di un'operazione di ripristino collettivo o eliminare un'operazione a lunga esecuzione per annullare un'operazione di ripristino collettivo mentre è in corso.
Per istruzioni sull'utilizzo delle operazioni a lunga esecuzione avviate da le operazioni in Cloud Storage, come l'operazione di ripristino collettivo, consulta Utilizza operazioni a lunga esecuzione.
L'esempio seguente mostra un'operazione a lunga esecuzione restituita da un operazione di ripristino collettivo:
done: false { "kind": "storage@operation", "name": "projects/_/buckets/my-bucket/operations/CiQyODRlMTY0My0wNGExLTQ3MWItOTE2Zi1hZmQ0ZmM4ZDc4MjQQAg", "metadata": { "@type": "type.googleapis.com/google.storage.v2.BulkRestoreObjectsMetadata", "commonMetadata": { "type": "bulk-restore-objects", "createTime": "2023-10-20T21:08:11.289Z", "updateTime": "2023-10-20T21:18:37.583Z", "endTime": "2023-10-20T21:18:37.583Z", "requestedCancellation": false, "progressPercent": -1, }, "allow_overwrite": false, "matchGlobs": ["*"], "succeededCount": "0", "failedCount": "0", "skippedCount": "0", }, "done": true, "response": { "@type": "type.googleapis.com/google.storage.v2.BulkRestoreObjectsResponse" } }
Passaggi successivi
- Scopri di più sull'eliminazione temporanea.