Impostazione e recupero di proprietà e metadati per le risorse del servizio BLOB

  • Articolo

I contenitori e i Blob supportano i metadati personalizzati, rappresentati come intestazioni HTTP. Le intestazioni dei metadati possono essere impostate su una richiesta che crea una nuova risorsa Blob o contenitore o su una richiesta che crea in modo esplicito una proprietà su una risorsa esistente.

In questo argomento sono contenute gli argomenti secondari seguenti:

Formato intestazione metadati

Operazioni sui metadati

Proprietà HTTP standard per contenitori e BLOB

I BLOB supportano anche i tag, un tipo speciale di metadati personalizzati indicizzati automaticamente dal servizio BLOB. Per altre informazioni, vedere Gestire e trovare i dati in Archiviazione BLOB di Azure con indice BLOB.

Formato dell'intestazione dei metadati

Le intestazioni dei metadati sono coppie nome-valore. Il formato per l'intestazione è:

x-ms-meta-name:string-value

A partire dalla versione 2009-09-19, i nomi dei metadati devono rispettare le regole di denominazione per gli identificatori C#.

Per i nomi viene fatta distinzione tra maiuscole e minuscole. Si noti che i nomi dei metadati mantengono la distinzione tra maiuscole e minuscole con cui sono stati creati, ma quando vengono impostati o letti tale distinzione è irrilevante. Se due o più intestazioni dei metadati con lo stesso nome vengono inviate per una risorsa, il servizio BLOB restituisce il codice di stato 400 (Richiesta non valida).

I metadati sono costituiti da coppie nome-valore. Le dimensioni totali consentite per tutte le coppie di metadati sono di un massimo di 8 KB.

Le coppie nome-valore di metadati sono intestazioni HTTP valide, pertanto sono conformi alle restrizioni imposte sulle intestazioni HTTP.

Operazioni sui metadati

I metadati su una risorsa contenitore o Blob possono essere recuperati o impostati direttamente, senza restituire o modificare il contenuto della risorsa.

Si noti che i valori dei metadati possono solo essere letti o scritti completamente; gli aggiornamenti parziali non sono supportati. L'impostazione dei metadati su una risorsa comporta la sovrascrittura di tutti i valori dei metadati esistenti per quella risorsa.

Recupero di proprietà e metadati

Le operazioni GET e HEAD consentono di recuperare le intestazioni dei metadati per il Blob o il contenitore specificato. L'operazione HEAD restituisce solo intestazioni; non restituisce un corpo della risposta.

La sintassi dell'URI per il recupero delle intestazioni dei metadati su un contenitore è la seguente:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container

La sintassi dell'URI per il recupero delle intestazioni dei metadati su un Blob è la seguente:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

Impostazioni delle intestazioni dei metadati

L'operazione PUT consente di impostare intestazioni dei metadati sul Blob o il contenitore specificato, sovrascrivendo eventuali metadati esistenti sulla risorsa. La chiamata dell'operazione PUT senza intestazioni sulla richiesta comporta la cancellazione di tutti i metadati esistenti sulla risorsa.

La sintassi dell'URI per l'impostazione delle intestazioni dei metadati su un contenitore è la seguente:

PUT https://myaccount.blob.core.windows.net/mycontainer?comp=metadata?restype=container

La sintassi dell'URI per l'impostazione delle intestazioni dei metadati su un Blob è la seguente:

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

Proprietà HTTP standard per contenitori e Blob

I contenitori e i Blob supportano le proprietà HTTP standard. Le proprietà e i metadati sono entrambi rappresentati come intestazioni HTTP standard; la differenza esistente tra di essi risiede nella denominazione delle intestazioni. Le intestazioni dei metadati sono denominate con il prefisso dell'intestazione x-ms-meta- e un nome personalizzato. Le intestazioni delle proprietà usano nomi di intestazione HTTP standard, come specificato nella sezione Definizioni campo intestazione 14 della specifica del protocollo HTTP/1.1.

Le intestazioni HTTP standard supportate sui contenitori includono:

  • ETag

  • Last-Modified

Le intestazioni HTTP standard supportate sui Blob includono:

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

  • Origin

  • Range

Vedere anche

Create Container
Ottenere le proprietà del contenitore
Impostare i metadati del contenitore
Put Blob
Copy Blob
Get Blob Properties
Get Blob Metadata
Set Blob Metadata
Concetti relativi al servizio Blob
Gestire e trovare i dati nell'Archiviazione BLOB di Azure con l'indice BLOB