Questa pagina descrive come abilitare, disabilitare e controllare lo stato del controllo delle versioni degli oggetti in un bucket. Consulta Utilizzo degli oggetti con controllo delle versioni per scoprire come elencare, ripristinare ed eliminare gli oggetti conservati dal controllo delle versioni degli oggetti.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per impostare e gestire il controllo delle versioni degli oggetti in un bucket, chiedi all'amministratore di concederti il ruolo IAM Amministratore Storage (roles/storage.admin
) per il bucket o per il progetto che contiene il bucket. Questo ruolo predefinito contiene le autorizzazioni necessarie per impostare e gestire il controllo delle versioni degli oggetti per un bucket. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
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.
Potresti essere in grado di ottenere queste autorizzazioni anche con i ruoli personalizzati.
Per informazioni sulla concessione dei ruoli nei bucket, consulta Utilizzare IAM con i bucket. Per informazioni sulla concessione dei ruoli sui progetti, consulta Gestire l'accesso ai progetti.
Imposta il controllo delle versioni degli oggetti 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 per il quale vuoi abilitare o disabilitare il controllo delle versioni degli oggetti.
Seleziona la scheda Protezione nella parte superiore della pagina.
Lo stato attuale del controllo delle versioni degli oggetti si trova nella sezione Controllo delle versioni degli oggetti.
Nella sezione Controllo delle versioni degli oggetti, fai clic sullo stato attuale per modificarlo.
Viene visualizzata la finestra di dialogo Controllo delle versioni degli oggetti.
- Se stai abilitando il controllo delle versioni degli oggetti e vuoi ridurre al minimo i costi di archiviazione, seleziona la casella di controllo Aggiungi regole del ciclo di vita consigliate per gestire i costi delle versioni.
Fai clic su Conferma.
Riga di comando
Utilizza il comando gcloud storage buckets update
con il flag appropriato:
gcloud storage buckets update gs://BUCKET_NAME FLAG
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.FLAG
è--versioning
per abilitare il controllo delle versioni degli oggetti o--no-versioning
per disabilitarlo.
In caso di esito positivo, la risposta sarà simile al seguente esempio:
Updating gs://my-bucket/... Completed 1
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita il controllo delle versioni degli oggetti in un bucket:
Il seguente esempio disabilita il controllo delle versioni degli oggetti in un bucket:
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita il controllo delle versioni degli oggetti in un bucket:
Il seguente esempio disabilita il controllo delle versioni degli oggetti in un bucket:
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita il controllo delle versioni degli oggetti in un bucket:
Il seguente esempio disabilita il controllo delle versioni degli oggetti in un bucket:
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita il controllo delle versioni degli oggetti in un bucket:
Il seguente esempio disabilita il controllo delle versioni degli oggetti in un bucket:
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita il controllo delle versioni degli oggetti in un bucket:
Il seguente esempio disabilita il controllo delle versioni degli oggetti in un bucket:
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita il controllo delle versioni degli oggetti in un bucket:
Il seguente esempio disabilita il controllo delle versioni degli oggetti in un bucket:
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita il controllo delle versioni degli oggetti in un bucket:
Il seguente esempio disabilita il controllo delle versioni degli oggetti in un bucket:
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita il controllo delle versioni degli oggetti in un bucket:
Il seguente esempio disabilita il controllo delle versioni degli oggetti in un bucket:
API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Crea un file JSON contenente le seguenti informazioni:
{ "versioning": { "enabled": STATE } }
Dove STATE è
true
ofalse
.Utilizza
cURL
per chiamare l'API JSON con una richiestaPATCH
di 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?fields=versioning"
Dove:
JSON_FILE_NAME
è il percorso del file JSON creato nel passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Crea un file XML contenente le seguenti informazioni:
<VersioningConfiguration> <Status>STATE</Status> </VersioningConfiguration>
Dove STATE è
Enabled
oSuspended
.Utilizza
cURL
per chiamare l'API XML, con una richiestaPUT
bucket e un parametro della stringa di queryversioning
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?versioning"
Dove:
XML_FILE_NAME
è il percorso del file XML che hai creato nel passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Una volta abilitato il controllo delle versioni degli oggetti, ogni volta che una versione attiva degli oggetti viene sostituita o eliminata, questa diventa una versione non corrente.
Controlla se il controllo delle versioni degli oggetti è abilitato
Per verificare se il controllo delle versioni degli oggetti è abilitato in un bucket:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, lo stato Controllo delle versioni degli oggetti di ogni bucket si trova nella colonna Protezione.
Se attivato, viene visualizzato il testo Controllo delle versioni degli oggetti.
Riga di comando
Utilizza il comando gcloud storage buckets describe
con il flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(versioning)"
Dove BUCKET_NAME
è il nome del bucket
di cui vuoi visualizzare lo stato, Ad esempio, my-bucket
.
Se l'operazione riesce e il controllo delle versioni degli oggetti è abilitato, la risposta è simile al seguente esempio:
versioning: enabled: true
Se l'operazione riesce e il controllo delle versioni degli oggetti non è abilitato, la risposta è simile al seguente esempio:
null
API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiestaGET
di bucket:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=versioning"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Se l'operazione riesce e il controllo delle versioni degli oggetti è abilitato, la risposta è simile al seguente esempio:
{ "versioning": { "enabled": true } }
Se l'operazione riesce e il controllo delle versioni degli oggetti non è abilitato, la risposta è simile al seguente esempio:
{}
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML, con una richiestaGET
bucket e un parametro della stringa di queryversioning
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?versioning"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Se l'operazione riesce e il controllo delle versioni degli oggetti è abilitato, la risposta è simile al seguente esempio:
<VersioningConfiguration> <Status>Enabled</Status> </VersioningConfiguration>
Se l'operazione riesce e il controllo delle versioni degli oggetti non è abilitato, la risposta è simile al seguente esempio:
<VersioningConfiguration/>
Passaggi successivi
- Scopri di più sul controllo delle versioni degli oggetti.
- Scopri come lavorare con oggetti non attuali.
- Scopri come utilizzare la gestione del ciclo di vita degli oggetti per gestire automaticamente le versioni degli oggetti.
- Scopri come utilizzare le precondizioni della richiesta per evitare le gare di gara.