Metadati del bucket

I metadati di un bucket Cloud Storage identificano le proprietà del bucket e ti consentono di controllarne il comportamento. I metadati di un bucket includono campi non modificabili, come il nome del bucket e il numero del progetto, nonché impostazioni configurabili, come la classe di archiviazione predefinita, le regole del ciclo di vita e i ruoli IAM.

Panoramica dei metadati dei bucket

I metadati vengono archiviati come coppie key: value, dove value può assumere diverse forme, tra cui stringhe, array o persino coppie key:value nidificate. Ad esempio, il nome del bucket è una stringa, mentre una configurazione di gestione del ciclo di vita degli oggetti del bucket è un array di regole in cui ogni regola contiene diverse coppie key: value secondarie.

La mutabilità dei metadati varia:

• Alcuni metadati sono di sola lettura.

• Alcuni metadati possono essere impostati quando il bucket viene creato, ma non possono essere modificati o rimossi.

• Alcuni metadati possono essere aggiunti e modificati, ma non possono essere rimossi.

• Alcuni metadati possono essere aggiunti, modificati e rimossi in qualsiasi momento.

Metadati non modificabili

I seguenti metadati vengono impostati durante la creazione del bucket e non possono essere modificati o rimossi:

• Nome bucket

• Il progetto di cui fa parte il bucket

• Numero generazione

  • Il numero di generazione di un bucket identifica in modo univoco la versione del bucket anche se più versioni di un bucket condividono lo stesso nome.

  • Il valore di generazione di un bucket non cambia mai.

  • Non è garantito che i numeri di generazione aumentino per le versioni successive, ma solo che ogni nuova versione abbia un numero di generazione univoco.

  • Non esiste alcuna relazione tra i numeri di generazione di bucket non correlati.

• Numero di metagenerazione

  • Il numero di metagenerazione di un bucket identifica in modo univoco lo stato dei metadati del bucket. Il numero di metagenerazione è 1 al momento della creazione del bucket e aumenta ogni volta che modifichi i metadati del bucket.

• Se lo spazio dei nomi gerarchico è abilitato per il bucket

Metadati modificabili

I metadati modificabili del bucket sono metadati i cui valori possono essere generalmente modificati in qualsiasi momento. In alcuni casi, ad esempio se il bucket è soggetto a un vincolo della policy dell'organizzazione, esistono limitazioni alla modifica di determinati valori dei metadati.

Panoramica dei metadati	Link alla guida	Note
Elenchi di controllo dell'accesso (ACL)	Creazione e gestione degli ACL	Consigliato solo per gli utenti XML.
ACL predefiniti	Imposta ACL degli oggetti predefiniti
Policy di Identity and Access Management (IAM)^1	Utilizza le autorizzazioni IAM
Fatturazione (Pagamenti a carico del richiedente)	Utilizza Pagamenti a carico del richiedente
Configurazione della condivisione di risorse multiorigine (CORS)	Configura e visualizza le configurazioni CORS
Classe di archiviazione predefinita	Modifica la classe di archiviazione predefinita	Impostata durante la creazione del bucket e può essere modificata, ma non rimossa.
Crittografia dei dati	Configura i metodi di crittografia consentiti o limitati	L'aggiornamento di questa impostazione non influisce sul tipo di crittografia degli oggetti già presenti nel bucket.
Chiave di crittografia Cloud KMS predefinita	Utilizza le chiavi Cloud KMS predefinite
Blocchi predefiniti basati su eventi^1	Utilizza la proprietà di conservazione basata su eventi predefinita
Prevenzione dell'accesso pubblico^1	Applica la prevenzione dell'accesso pubblico
Accesso uniforme a livello di bucket^1	Utilizza l'accesso uniforme a livello di bucket	Modificabile solo per i primi 90 giorni dopo l'attivazione dell'accesso uniforme a livello di bucket su un bucket.
Policy di configurazione del ciclo di vita	Gestisci i cicli di vita degli oggetti
Autoclass	Utilizza Autoclass
Replica turbo^1	Gestisci la replica turbo
Log di utilizzo e log di archiviazione	Configurazione dei log di utilizzo
Blocco di bucket^2	Utilizza e blocca le policy di conservazione	Modificabile solo se non blocchi la policy di conservazione.
Blocco della conservazione degli oggetti	Abilita e utilizza le configurazioni di conservazione degli oggetti	Una volta abilitata per un bucket, non può essere disabilitata.
Configurazione del controllo delle versioni degli oggetti	Utilizza il controllo delle versioni degli oggetti
Etichette dei bucket	Utilizza le etichette dei bucket
Durata di conservazione dell'eliminazione temporanea	Utilizza l'eliminazione temporanea
Configurazione del sito web	Assegna pagine speciali per i siti web statici
Località del bucket	Sposta i bucket	Prima di trasferire un bucket, consulta la pagina Panoramica della rilocalizzazione dei bucket.

¹ Questi metadati non possono essere visualizzati o gestiti utilizzando l'API XML.

² Puoi utilizzare l'API XML per impostare questi metadati durante la creazione del bucket, ma non per visualizzarli o gestirli.

Passaggi successivi

• Scopri come visualizzare i metadati dei bucket.
• Scopri come ottenere le dimensioni del bucket.
• Scopri di più sui bucket.
• Scopri di più sui metadati degli oggetti.