Nastavení a načítání vlastností a metadat pro prostředky služby Blob Service

Kontejnery a objekty blob podporují vlastní metadata reprezentovaná jako hlavičky HTTP. Hlavičky metadat je možné nastavit u požadavku, který vytvoří nový prostředek kontejneru nebo objektu blob, nebo na žádost, která explicitně vytvoří vlastnost existujícího prostředku.

Toto téma obsahuje následující dílčí témata:

Formát záhlaví metadat

Operace s metadaty

Standardní vlastnosti HTTP pro kontejnery a objekty blob

Objekty blob také podporují značky, speciální typ vlastních metadat, která služba Blob Service automaticky indexuje. Další informace najdete v tématu Správa a hledání dat v Azure Blob Storage pomocí indexu objektů blob.

Formát záhlaví metadat

Hlavičky metadat jsou páry název/hodnota. Formát hlavičky je:

x-ms-meta-name:string-value  

Od verze 2009-09-19 musí názvy metadat splňovat pravidla pojmenování pro identifikátory jazyka C#.

V názvech se nerozlišují malá a velká písmena. Všimněte si, že názvy metadat zachovávají velikost písmen, se kterými byly vytvořeny, ale při nastavení nebo čtení nerozlišují malá a velká písmena. Pokud se pro prostředek odesílají dvě nebo více hlaviček metadat se stejným názvem, vrátí služba Blob Service stavový kód 400 (Chybný požadavek).

Metadata se skládají z párů název/hodnota. Celková velikost všech párů metadat může být až 8 kB.

Dvojice název/hodnota metadat jsou platné hlavičky HTTP, a proto dodržují všechna omezení, kterými se hlavičky HTTP řídí.

Operace s metadaty

Metadata prostředku objektu blob nebo kontejneru je možné načíst nebo nastavit přímo, aniž by se vrátil nebo změnil obsah prostředku.

Všimněte si, že hodnoty metadat lze číst nebo zapisovat pouze v plném rozsahu; částečné aktualizace nejsou podporovány. Nastavení metadat pro prostředek přepíše všechny existující hodnoty metadat pro tento prostředek.

Načítání vlastností a metadat

Operace GET a HEAD načítají hlavičky metadat pro zadaný kontejner nebo objekt blob. Operace HEAD vrací pouze hlavičky; nevrací text odpovědi.

Syntaxe identifikátoru URI pro načítání hlaviček metadat v kontejneru je následující:

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

Syntaxe identifikátoru URI pro načítání hlaviček metadat v objektu blob je následující:

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

Nastavení hlaviček metadat

Operace PUT nastaví hlavičky metadat v zadaném kontejneru nebo objektu blob a přepíše všechna existující metadata prostředku. Volání PUT bez jakýchkoli hlaviček v požadavku vymaže všechna existující metadata prostředku.

Syntaxe identifikátoru URI pro nastavení hlaviček metadat v kontejneru je následující:

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

Syntaxe identifikátoru URI pro nastavení hlaviček metadat v objektu blob je následující:

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

Standardní vlastnosti HTTP pro kontejnery a objekty blob

Kontejnery a objekty blob také podporují určité standardní vlastnosti HTTP. Vlastnosti a metadata jsou reprezentovány jako standardní hlavičky HTTP; Rozdíl mezi nimi je v pojmenování hlaviček. Hlavičky metadat jsou pojmenovány s předponou x-ms-meta- hlavičky a vlastním názvem. Hlavičky vlastností používají standardní názvy hlaviček HTTP, jak je uvedeno v části Definice polí hlaviček v části 14 specifikace protokolu HTTP/1.1.

Mezi standardní hlavičky HTTP podporované v kontejnerech patří:

  • ETag

  • Last-Modified

Mezi standardní hlavičky HTTP podporované u objektů blob patří:

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

  • Origin

  • Range

Viz také

Vytvoření kontejneru
Získání vlastností kontejneru
Nastavení metadat kontejneru
Vložení objektu blob
Zkopírování objektu blob
Získání vlastností objektu blob
Získání metadat objektu blob
Nastavení metadat objektu blob
Koncepty služby Blob Service
Správa a vyhledávání dat ve službě Azure Blob Storage s využitím indexu objektů blob