Metadati degli oggetti

Gestisci

Questa pagina illustra i campi dei metadati di uso comune che vengono archiviati insieme agli oggetti in Cloud Storage.

Introduzione

Gli oggetti archiviati in Cloud Storage hanno metadati associati. I metadati identificano le proprietà dell'oggetto e specificano in che modo deve essere gestito quando viene eseguito l'accesso. I metadati esistono come coppie chiave:valore. Ad esempio, la classe di archiviazione di un oggetto è rappresentata dalla voce dei metadati storageClass:STANDARD. storageClass è la chiave per i metadati e a tutti gli oggetti è associata una chiave di questo tipo. STANDARD specifica il valore di questo oggetto specifico e il valore varia da un oggetto all'altro.

La mutabilità dei metadati varia: alcuni possono essere modificati in qualsiasi momento, alcuni possono essere impostati solo al momento della creazione dell'oggetto e altri possono essere solo visualizzati. Ad esempio, puoi modificare il valore dei metadati Cache-Control in qualsiasi momento, ma puoi assegnare i metadati storageClass solo quando l'oggetto viene creato o riscritto e non puoi modificare direttamente il valore per i metadati generation, anche se il valore generation cambia quando l'oggetto viene sostituito.

Metadati modificabili

Esistono due categorie di metadati che gli utenti possono modificare per gli oggetti:

• Metadati a chiave fissa: metadati le cui chiavi sono impostate, ma per i quali puoi specificare un valore.

• Metadati personalizzati: i metadati che aggiungi specificando sia una chiave sia un valore associato alla chiave.

Quando modifichi i metadati, in genere dovresti evitare i caratteri non ASCII, poiché non sono consentiti nelle intestazioni HTTP utilizzate dall'API XML.

Metadati a chiave fissa

Puoi modificare i seguenti metadati per gli oggetti, ma devi disporre dell'autorizzazione sufficiente per farlo:

• Metadati del controllo dell'accesso
• Cache-Control
• Content-Disposition
• Content-Encoding
• Content-Language
• Content-Type
• Custom-Time
• Blocco di oggetti
• Configurazione della conservazione

Metadati del controllo dell'accesso

Cloud Storage utilizza Identity and Access Management (IAM) e elenchi di controllo dell'accesso (ACL) per controllare l'accesso agli oggetti. Utilizza questi link per scoprire di più su questi metodi di controllo dell'accesso#39;accesso e sui metadati associati.

Cache-Control

I metadati Cache-Control possono specificare due aspetti diversi della modalità di pubblicazione dei dati da Cloud Storage: se i dati possono essere memorizzati nella cache e se possono essere trasformati.

Nota: Cache-Control è anche un'intestazione che puoi specificare nelle richieste HTTP per un oggetto. Tuttavia, Cloud Storage ignora questa intestazione e imposta le intestazioni Cache-Control di risposta in base ai valori dei metadati archiviati.

Memorizzazione nella cache dei dati

I metadati Cache-Control ti consentono di controllare se e per quanto tempo le cache sono autorizzate a memorizzare nella cache i tuoi oggetti, che possono poi essere pubblicati per soddisfare le richieste future. Le cache possono includere le cache del browser e di internet, nonché la cache integrata di Cloud Storage.

Se un oggetto applicabile non ha una voce di metadati Cache-Control, Cloud Storage utilizza il valore predefinito di:

• public, max-age=3600, se l'oggetto non è criptato utilizzando una chiave di crittografia gestita dal cliente o memorizzato all'interno di un perimetro del servizio Virtual Private Cloud.

• no-cache, no-store, max-age=0, se l'oggetto è criptato utilizzando una chiave di crittografia gestita dal cliente.

• private, max-age=0, se l'oggetto è archiviato all'interno di un perimetro del servizio Virtual Private Cloud.

• no-cache, no-store, max-age=0, must-revalidate, se l'oggetto è archiviato all'interno di un perimetro del servizio Virtual Private Cloud e criptato utilizzando una chiave di crittografia gestita dal cliente.

Se consenti la memorizzazione nella cache, i download potrebbero continuare a ricevere versioni precedenti di un oggetto anche dopo aver caricato una versione più recente. Questo perché queste versioni precedenti rimangono "aggiornate" nelle cache per un periodo di tempo determinato da max-age. Inoltre, poiché gli oggetti possono essere memorizzati nella cache in vari punti su internet, non è possibile forzare la scadenza di un oggetto memorizzato nella cache a livello globale. Ciò significa che se revochi l'accesso pubblico a un oggetto, l'oggetto può comunque essere visualizzato da una cache, a seconda dell'ultima volta che è stato visualizzato e della relativa impostazione Cache-Control. Ad esempio, se l'oggetto è stato pubblicato con un valore Cache-Control di public, max-age=3600, può rimanere in una cache per un'ora. Se vuoi impedire la pubblicazione di versioni memorizzate nella cache di oggetti di dominio pubblico, imposta Cache-Control: no-store sull'oggetto.

Se hai bisogno di un maggiore controllo sul comportamento della cache, puoi configurare Cloud CDN davanti al tuo bucket.

Trasformazione dei dati

I metadati Cache-Control ti consentono anche di pubblicare gli oggetti così come sono archiviati, senza applicare trasformazioni ai dati, ad esempio rimuovere la codifica del contenuto gzip per i client incompatibili. Per pubblicare un oggetto così com'è, imposta Cache-Control:no-transform.

Content-Disposition

I metadati Content-Disposition specificano informazioni sulla presentazione dei dati trasmessi. L'impostazione Content-Disposition consente di controllare lo stile di presentazione dei contenuti, ad esempio determinare se un allegato deve essere visualizzato automaticamente o se è necessaria qualche forma di azione da parte dell'utente per aprirlo. Per la specifica Content-Disposition, consulta https://datatracker.ietf.org/doc/html/rfc6266.

Content-Encoding

I metadati Content-Encoding possono essere utilizzati per indicare che un oggetto è compresso, mantenendo al contempo il Content-Type sottostante dell'oggetto. Ad esempio, un file di testo compresso con gzip può avere il fatto che si tratta di un file di testo indicato in Content-Type e il fatto che è compresso con gzip indicato in Content-Encoding. Prima di caricarli, devi assicurarti che i file siano effettivamente compressi utilizzando il Content-Encoding specificato, altrimenti potrebbero verificarsi comportamenti imprevisti durante il tentativo di scaricare gli oggetti. Per ulteriori informazioni, consulta la pagina Transcodifica.

Per i contenuti comprimibili, come il testo, l'utilizzo di Content-Encoding: gzip consente di risparmiare sui costi di rete e di archiviazione e di migliorare le prestazioni di pubblicazione dei contenuti. Tuttavia, per i contenuti già compressi per impostazione predefinita, come gli archivi e molti formati multimediali, l'applicazione di un altro livello di compressione e il relativo inserimento nei metadati Content-Encoding è in genere dannosa sia per le dimensioni dell'oggetto sia per il rendimento e deve essere evitata.

Content-Language

I metadati Content-Language indicano le lingue per le quali è destinato l'oggetto. Fai riferimento ai codici lingua ISO 639-1 per i valori tipici di questi metadati.

Cloud Storage supporta valori Content-Language con una lunghezza massima di 100 caratteri.

Content-Type

I metadati impostati più di frequente sono Content-Type (noto anche come tipo di media), che consente ai browser di visualizzare correttamente l'oggetto. Tutti gli oggetti hanno un valore specificato nei metadati Content-Type, ma questo valore non deve corrispondere al tipo sottostante dell'oggetto. Ad esempio, se Content-Type non è specificato dall'utente che ha caricato l'elemento e non può essere determinato, viene impostato su application/octet-stream o application/x-www-form-urlencoded, a seconda del modo in cui è stato caricato l'oggetto. Per un elenco dei tipi di contenuti validi, consulta la pagina Tipi di media IANA.

Nota: alcuni strumenti, come gcloud storage, tentano di impostare automaticamente Content-Type al momento del caricamento in base all'estensione del file caricato. Tuttavia, qualsiasi valore esplicito impostato per Content-Type ha la precedenza su questo meccanismo.

Custom-Time

I metadati Custom-Time sono una data e un'ora specificate dall'utente rappresentate nel formato RFC 3339 YYYY-MM-DD'T'HH:MM:SS.SS'Z' o YYYY-MM-DD'T'HH:MM:SS'Z' quando i millisecondi sono pari a zero. Questi metadati vengono solitamente impostati per utilizzare la condizione DaysSinceCustomTime nella gestione del ciclo di vita degli oggetti.

Non puoi rimuovere Custom-Time una volta impostato su un oggetto. Inoltre, il valore di Custom-Time non può diminuire. In altre parole, non puoi impostare Custom-Time su una data/ora precedente a quella esistente di Custom-Time. Puoi tuttavia rimuovere o reimpostare Custom-Time in modo efficace riscrivendo l'oggetto.

Blocchi degli oggetti

Utilizza gli indicatori dei metadati per inserire blocchi degli oggetti, che impediscono l'eliminazione o la sostituzione degli oggetti. Per ulteriori informazioni, consulta la pagina Archiviazione a fini legali degli oggetti.

Configurazione della conservazione

Se presente, la configurazione della conservazione di un oggetto definisce una data e un'ora prima delle quali l'oggetto non può essere eliminato o sostituito. Per ulteriori informazioni, consulta Blocco della conservazione degli oggetti.

Metadati personalizzati

I metadati personalizzati sono metadati per i quali definisci sia la chiave sia il valore. Per creare metadati personalizzati, specifica sia una chiave sia un valore. Dopo aver creato una coppia di metadati personalizzati key:value, puoi eliminare la chiave o modificare il valore.

I metadati personalizzati sono soggetti a un limite di dimensioni e comportano costi di archiviazione.

La pagina Visualizzazione e modifica dei metadati include informazioni su come impostare i metadati personalizzati.

Il prefisso x-goog-meta-

L'API XML imposta e recupera i metadati degli oggetti utilizzando gli intestazioni di richiesta, mentre l'API JSON consente di impostare metadati personalizzati nella richiesta finale di un caricamento riavviabile utilizzando gli intestazioni di richiesta. Per distinguere chiaramente le intestazioni dei metadati personalizzati dalle intestazioni delle richieste standard, entrambe le API prefiggono queste intestazioni dei metadati personalizzati con x-goog-meta-.

Metadati non modificabili

Alcuni metadati non possono essere modificati direttamente. Questi metadati vengono impostati al momento della creazione o della riscrittura dell'oggetto. Durante la creazione o la riscrittura dell'oggetto, puoi impostare alcuni di questi metadati, ad esempio la classe di archiviazione dell'oggetto o le chiavi di crittografia gestite dal cliente. Altri metadati vengono aggiunti automaticamente e possono essere visualizzati, ad esempio il numero di generazione dell'oggetto o l'ora di creazione.

Numeri di generazione e metagenerazione

Come parte dei metadati, ogni oggetto Cloud Storage ha una proprietà numerica generation e una proprietà numerica metageneration che identifica in modo univoco l'oggetto:

Proprietà	Descrizione
generation	Identifica la versione di un oggetto ed esiste per ogni oggetto, indipendentemente dal fatto che un bucket utilizzi il controllo delle versioni degli oggetti. Il valore generation di una versione dell'oggetto non cambia mai. Un nuovo oggetto con lo stesso nome può sostituire un oggetto esistente, ma al nuovo oggetto viene sempre assegnato un generation diverso. 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 oggetti non correlati, anche se si trovano nello stesso bucket.
metageneration	Identifica la versione dei metadati e aumenta ogni volta che i metadati di un determinato generation vengono aggiornati. metageneration inizia a 1 per ogni nuovo generation di un oggetto. La proprietà metageneration non ha significato senza la proprietà generation e deve essere utilizzata solo in combinazione con quest'ultima. Non ha senso confrontare le generazioni di metadati di due versioni di oggetti.

Le proprietà generation e metageneration vengono utilizzate nelle seguenti circostanze:

• Quando utilizzi le condizioni preliminari nelle richieste: le condizioni preliminari fanno sì che la richiesta non vada a buon fine se la condizione preliminare non è soddisfatta. In questo modo, si impedisce che la richiesta venga applicata a una versione imprevista di un oggetto, ad esempio recuperando i dati dell'oggetto errati o modificando lo stato errato dei metadati di un oggetto.

• Quando elenchi, accedi, ripristini ed elimini le versioni non correnti degli oggetti: le versioni non correnti degli oggetti sono pertinenti in modo specifico nei bucket che utilizzano o hanno utilizzato in precedenza il controllo delle versioni degli oggetti.

Checksum

I checksum sono metadati calcolati dai dati dell'oggetto associato. I checksum vengono utilizzati per verificare che i dati dell'oggetto non siano danneggiati. Gli oggetti Cloud Storage hanno diversi campi dei metadati di controllo.

CRC32C

Tutti gli oggetti Cloud Storage hanno un hash CRC32C. Le librerie per calcolare CRC32C includono:

• CRC32C di Google per C++
• hash/crc32 per Go
• GoogleAPIs Guava per Java
• google-crc32c per Python
• digest-crc in Ruby

Nota: il CRC comunemente noto come CRC32 è diverso dall'algoritmo CRC32C utilizzato da Cloud Storage.

Il CRC32C con codifica Base64 è in ordine di byte big-endian.

MD5

Gli oggetti Cloud Storage hanno un hash MD5 se soddisfano i seguenti criteri:

• L'oggetto non è un oggetto composito
• L'oggetto non è stato caricato utilizzando un caricamento multiparte dell'API XML

Questo hash si applica solo a un oggetto completo, pertanto non può essere utilizzato per verificare l'integrità scaricamenti parziali causati dall'esecuzione di un comando GET con intervallo.

ETags

Tutti gli oggetti Cloud Storage hanno un ETag. Tuttavia, lo stesso oggetto può avere un valore ETag diverso se viene richiesto dall'API XML rispetto all'API JSON. Nella maggior parte dei casi, gli utenti non devono fare supposizioni sul valore utilizzato in un ETag, tranne per il fatto che cambia ogni volta che cambiano i dati o i metadati sottostanti, come indicato nella specifica.

L'intestazione ETag di un oggetto restituisce il valore MD5 dell'oggetto se tutte le seguenti condizioni sono vere:

• La richiesta viene effettuata tramite l'API XML
• L'oggetto utilizza solo chiavi di proprietà di Google e gestite da Googlechiavi di crittografia basate su Google Cloud per la crittografia lato server
• L'oggetto non è un oggetto composito e non è stato caricato utilizzando un caricamento multiparte dell'API XML

Ora di modifica

Come parte dei metadati, ogni oggetto Cloud Storage ha una proprietà updated che indica l'ultima volta che i metadati dell'oggetto sono stati modificati. L'ora updated viene inizialmente impostata sull'ora di creazione dell'oggetto e poi cambia ogni volta che cambiano i metadati dell'oggetto. Sono incluse le modifiche apportate da un richiedente, come la modifica dei metadati personalizzati, nonché le modifiche apportate da Cloud Storage per conto di un richiedente, come la modifica della classe di archiviazione in base a una configurazione del ciclo di vita degli oggetti.

Passaggi successivi

• Visualizza e modifica i metadati degli oggetti.
• Scopri le classi di archiviazione disponibili.
• Per una descrizione dettagliata di tutti i campi dei metadati degli oggetti disponibili nell'API JSON, consulta la documentazione di riferimento sugli oggetti per JSON.
• Scopri di più sui report sull'inventario di Storage Insights, che ti consentono di recuperare contemporaneamente i metadati di tutti gli oggetti in un bucket.