In questa pagina viene descritto come attivare, disattivare, aggiornare e controllare lo stato del di eliminazione temporanea su un bucket. Per scoprire come elencare e ripristinare oggetti eliminati temporaneamente, consulta Utilizzare oggetti eliminati temporaneamente. Per ulteriori informazioni sull'eliminazione temporanea, consulta la Panoramica.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per creare e gestire i criteri di eliminazione temporanea,
chiedi all'amministratore di concederti
Ruolo IAM Storage Admin (roles/storage.admin
) nel bucket o nel progetto che lo contiene.
Questo ruolo predefinito contiene le autorizzazioni necessarie per creare e gestire i criteri di eliminazione temporanea. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare e gestire i criteri di eliminazione temporanea, sono necessarie le seguenti autorizzazioni:
-
storage.buckets.get
-
storage.buckets.update
-
storage.buckets.list
(questa autorizzazione è necessaria solo se prevedi di utilizzare la console Google Cloud per eseguire le istruzioni in questa pagina)
Per informazioni sulla concessione dei ruoli, consulta Utilizza IAM con i bucket o Gestisci l'accesso ai progetti.
Modifica il criterio di eliminazione temporanea di un bucket
Per abilitare, disabilitare o aggiornare il criterio di eliminazione temporanea per un bucket:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket il criterio di eliminazione temporanea che vuoi gestire.
Fai clic sulla scheda Protezione.
Nella sezione Criterio di eliminazione temporanea, esegui una delle seguenti operazioni azioni:
Se il bucket non ha un criterio di eliminazione temporanea, Fai clic su Modifica, scegli un'unità di tempo e una durata per la durata di conservazione e fai clic su Salva.
Se il bucket ha un criterio di eliminazione temporanea, fai clic su Modifica per modifica l'unità di tempo e la durata della conservazione durata massima.
Scopri come ottenere informazioni dettagliate sugli errori relativi a Cloud Storage non riusciti nella console Google Cloud, vedi Risoluzione dei problemi.
Riga di comando
Per aggiungere o modificare il criterio di eliminazione temporanea su un bucket, utilizza
gcloud storage buckets update
con il comando
Flag --soft-delete-duration
:
gcloud storage buckets update gs://BUCKET_NAME --soft-delete-duration=SOFT_DELETE_DURATION
Dove:
BUCKET_NAME
è il nome del bucket. Ad esempio,my-bucket
.SOFT_DELETE_DURATION
specifica la durata e conservare gli oggetti eliminati temporaneamente. Ad esempio,2w1d
corrisponde a due settimane e uno giorno. Per ulteriori informazioni, vedi tempo di conservazione dell'eliminazione temporanea.
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
.Crea un file JSON contenente le seguenti informazioni:
{ "softDeletePolicy": { "retentionDurationSeconds": "TIME_IN_SECONDS" } }
Dove
TIME_IN_SECONDS
è la quantità di tempo in secondi per cui vuoi conservare gli oggetti eliminati temporaneamente. Ad esempio,2678400
. Per ulteriori informazioni, vedi tempo di conservazione dell'eliminazione temporanea.Utilizza
cURL
per chiamare l'API JSON con un RichiestaPATCH
bucket:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
Dove:
JSON_FILE_NAME
è il percorso del file JSON creato nel passaggio 2.BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.
Elimina il criterio di eliminazione temporanea di un bucket
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket il criterio di eliminazione temporanea che vuoi eliminare.
Fai clic sulla scheda Protezione.
Nella sezione Criterio di eliminazione temporanea, fai clic su Disattiva per rimuovere il di eliminazione temporanea per il bucket.
Fai clic su Conferma.
Per disabilitare, puoi anche impostare la durata del criterio su 0 giorni. Puoi anche disabilita i criteri di eliminazione temporanea su più bucket in blocco
Scopri come ottenere informazioni dettagliate sugli errori relativi a Cloud Storage non riusciti nella console Google Cloud, vedi Risoluzione dei problemi.
Riga di comando
Per rimuovere il criterio di eliminazione temporanea da un bucket, utilizza il metodo
Comando gcloud storage buckets update
con --clear-soft-delete
Segnala:
gcloud storage buckets update gs://BUCKET_NAME --clear-soft-delete
Dove:
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
.Crea un file JSON contenente le seguenti informazioni:
{ "softDeletePolicy": { "retentionDurationSeconds": "TIME_IN_SECONDS" } }
Per disabilitare il criterio di eliminazione temporanea per un bucket, utilizza il metodo valore
0
perTIME_IN_SECONDS
.Utilizza
cURL
per chiamare l'API JSON con un RichiestaPATCH
bucket:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
Dove:
JSON_FILE_NAME
è il percorso del file JSON creato nel passaggio 2.BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.
Controllare se il criterio di eliminazione temporanea è abilitato su un bucket
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket il criterio di eliminazione temporanea che vuoi controllare.
Fai clic sulla scheda Protezione.
Lo stato viene visualizzato nel criterio di eliminazione temporanea (per il recupero dei dati) .
Puoi anche utilizzare la scheda Protezione per controllare se è presente di eliminazione temporanea sul tuo bucket.
Scopri come ottenere informazioni dettagliate sugli errori relativi a Cloud Storage non riusciti nella console Google Cloud, vedi Risoluzione dei problemi.
Riga di comando
Per controllare lo stato del criterio di eliminazione temporanea di un bucket, utilizza
Comando gcloud storage buckets describe
:
gcloud storage buckets describe gs://BUCKET_NAME \ --format="default(soft_delete_policy)"
Dove:
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 RichiestaGET
bucket: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?fields=softDeletePolicy"
Dove
BUCKET_NAME
è il nome del del bucket pertinente. Ad esempio,my-bucket
.
Disabilita l'eliminazione temporanea per più bucket o tutti i bucket all'interno di un progetto
Console
La console Google Cloud ti consente di disabilitare l'eliminazione temporanea per bucket ordinati in base al numero di byte eliminati temporaneamente o al rapporto più alto da byte eliminati temporaneamente a byte live, in modo da ridurre i costi sostenuti dall'utilizzo l'eliminazione temporanea.
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nella pagina Cloud Storage, fai clic su Impostazioni.
Fai clic sulla scheda Eliminazione temporanea.
Dall'elenco Bucket principali per byte eliminati, seleziona i bucket per cui vuoi disabilitare l'eliminazione temporanea.
Fai clic su Disattiva eliminazione temporanea.
L'eliminazione temporanea è disabilitata sui bucket che selezionato.
Riga di comando
Per disabilitare l'eliminazione temporanea per tutti i bucket all'interno di un progetto, esegui
Comando gcloud storage buckets update
con --clear-soft-delete
Segnala:
gcloud storage buckets update --clear-soft-delete gs://*
Librerie client
Python
Per ulteriori informazioni, consulta API Cloud Storage Python documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Passaggi successivi
- Scopri come utilizzare oggetti eliminati temporaneamente.