Questa pagina descrive come abilitare, disabilitare e controllare lo stato del controllo delle versioni degli oggetti in un bucket. Per informazioni su come elencare, ripristinare ed eliminare gli oggetti conservati dal controllo delle versioni degli oggetti, consulta Utilizzo degli oggetti con controllo delle versioni.
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
) sul bucket o sul 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 esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.update
storage.buckets.list
- Questa autorizzazione è richiesta solo se prevedi di utilizzare la console Google Cloud per eseguire le istruzioni in questa pagina.
Potresti anche riuscire a ottenere queste autorizzazioni con i ruoli personalizzati.
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.
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 abiliti 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 della versione.
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.
Se l'esito è positivo, la risposta è simile al seguente esempio:
Updating gs://my-bucket/... Completed 1
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente abilita il controllo delle versioni degli oggetti su un bucket:
L'esempio seguente disabilita il controllo delle versioni degli oggetti in un bucket:
C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente abilita il controllo delle versioni degli oggetti su un bucket:
L'esempio seguente disabilita il controllo delle versioni degli oggetti in un bucket:
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente abilita il controllo delle versioni degli oggetti su un bucket:
L'esempio seguente disabilita il controllo delle versioni degli oggetti in un bucket:
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente abilita il controllo delle versioni degli oggetti su un bucket:
L'esempio seguente disabilita il controllo delle versioni degli oggetti in un bucket:
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente abilita il controllo delle versioni degli oggetti su un bucket:
L'esempio seguente disabilita il controllo delle versioni degli oggetti in un bucket:
PHP
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente abilita il controllo delle versioni degli oggetti su un bucket:
L'esempio seguente disabilita il controllo delle versioni degli oggetti in un bucket:
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente abilita il controllo delle versioni degli oggetti su un bucket:
L'esempio seguente disabilita il controllo delle versioni degli oggetti in un bucket:
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente abilita il controllo delle versioni degli oggetti su un bucket:
L'esempio seguente disabilita il controllo delle versioni degli oggetti in un bucket:
API REST
API JSON
Installa e inizializzatogcloud CLI per 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
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 al passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
Installa e inizializzatogcloud CLI per 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 che contenga 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 di 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 creato al 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 dell'oggetto viene sostituita o eliminata, questa versione diventa una versione non corrente.
Verificare se il controllo delle versioni degli oggetti è abilitato
Per verificare se il controllo delle versioni degli oggetti è abilitato su un bucket:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, lo stato del controllo delle versioni degli oggetti di ogni bucket si trova nella colonna Protezione.
Se questa opzione è abilitata, 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
.
In caso di esito positivo e se è abilitato il controllo delle versioni degli oggetti, la risposta è simile al seguente esempio:
versioning: enabled: true
Se l'operazione ha esito positivo e il controllo delle versioni degli oggetti non è abilitato, la risposta è simile al seguente esempio:
null
API REST
API JSON
Installa e inizializzatogcloud CLI per 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
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
.
In caso di esito positivo e se è abilitato il controllo delle versioni degli oggetti, la risposta è simile al seguente esempio:
{ "versioning": { "enabled": true } }
Se l'operazione ha esito positivo e il controllo delle versioni degli oggetti non è abilitato, la risposta è simile al seguente esempio:
{}
API XML
Installa e inizializzatogcloud CLI per 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 di 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
.
In caso di esito positivo e se è abilitato il controllo delle versioni degli oggetti, la risposta è simile al seguente esempio:
<VersioningConfiguration> <Status>Enabled</Status> </VersioningConfiguration>
Se l'operazione ha esito positivo 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 correnti.
- Scopri come utilizzare Gestione del ciclo di vita degli oggetti per gestire automaticamente le versioni degli oggetti.
- Scopri come utilizzare le condizioni preliminari per le richieste per prevenire le condizioni di gara.