Získání metadat objektu blob

  • Článek
  • 4 min ke čtení

Operace Get Blob Metadata vrátí všechna uživatelem definovaná metadata pro zadaný objekt blob nebo snímek.

Žádost

Požadavek Get Blob Metadata lze zkonstruovat následujícím způsobem. Doporučuje se protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště:

GET nebo HEAD – identifikátor URI požadavku metody Verze PROTOKOLU HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata&snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata&versionid=<DateTime>		 HTTP/1.1

Emulovaný identifikátor URI služby úložiště

Při vytváření požadavku na emulovanou službu úložiště zadejte název hostitele emulátoru a Blob service port jako a za ním 127.0.0.1:10000 emulovaný název účtu úložiště:

GET nebo HEAD – identifikátor URI požadavku metody Verze PROTOKOLU HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=metadata HTTP/1.1

Další informace najdete v tématu Použití Azure Storage Emulator pro vývoj a testování.

Parametry identifikátoru URI

V identifikátoru URI požadavku je možné zadat následující další parametry.

Parametr Popis
snapshot Nepovinný parametr. Parametr snapshot je neprůhledná hodnota, která v případě přítomnosti určuje snímek DateTime objektu blob, který se má načíst. Další informace o práci se snímky objektů blob najdete v tématu Vytvoření snímku objektu blob.
versionid Volitelné, verze z 12. 12. 2019 a novější. Parametr versionid je neprůhledná hodnota, která v případě přítomnosti určuje verzi objektu DateTime blob, který se má načíst.
timeout Nepovinný parametr. Parametr timeout je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Blob Service.

Hlavičky požadavku

Následující tabulka popisuje povinné a volitelné hlavičky požadavku.

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků na Azure Storage.
Date nebo x-ms-date Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků na Azure Storage.
x-ms-version Vyžaduje se pro všechny autorizované požadavky, volitelné pro anonymní požadavky. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu o verzích pro Azure Storage Services.
x-ms-lease-id:<ID> Nepovinný parametr. Pokud je zadaná tato hlavička, operace se Get Blob Metadata provede pouze v případě, že jsou splněny obě následující podmínky:

– Zapůjčení objektu blob je aktuálně aktivní.
– ID zapůjčení zadané v požadavku odpovídá ID objektu blob.

Pokud nejsou splněny obě tyto podmínky, požadavek selže a operace selže se stavový Get Blob Metadata kódem 412 (Předběžná podmínka selhala).
x-ms-client-request-id Nepovinný parametr. Poskytuje neprůhlednou hodnotu vygenerovanou klientem s limitem 1 kiB znaků, který se zaznamená do analytických protokolů, když je povolené protokolování analýzy úložiště. Použití této hlavičky se důrazně doporučuje pro korelaci aktivit na straně klienta s požadavky přijatými serverem. Další informace najdete v tématu Protokolování Storage Analytics a Protokolování Azure: Použití protokolů ke sledování Storage požadavků.

Tato operace také podporuje použití podmíněných hlaviček k získání operace metadat objektu blob pouze v případě, že je splněna zadaná podmínka. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Service.

Hlavičky požadavku (šifrovací klíče poskytnuté zákazníkem)

Počínaje verzí 2019-02-02 je možné v požadavku zadat následující hlavičky pro čtení objektu blob zašifrovaného pomocí klíče poskytnutého zákazníkem. Šifrování pomocí klíče poskytnutého zákazníkem (a odpovídající sady hlaviček) je volitelné. Pokud byl objekt blob dříve zašifrován pomocí klíče poskytnutého zákazníkem, musí být tyto hlavičky součástí požadavku, aby se operace čtení úspěšně dokončila.

Hlavička požadavku Popis
x-ms-encryption-key Povinná hodnota. Šifrovací klíč AES-256 s kódováním Base64.
x-ms-encryption-key-sha256 Nepovinný parametr. Hodnota hash SHA256 šifrovacího klíče s kódováním Base64.
x-ms-encryption-algorithm: AES256 Povinná hodnota. Určuje algoritmus, který se má použít pro šifrování. Hodnota této hlavičky musí být AES256 .

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Informace o stavových kódech najdete v tématu Stavové a chybové kódy.

Hlavičky odpovědi

Odpověď pro tuto operaci zahrnuje následující hlavičky. Odpověď může obsahovat také další standardní hlavičky PROTOKOLU HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Popis
x-ms-meta-name:value Vrátí hodnotu metadat kontejneru.
Last-Modified Datum a čas poslední změny objektu blob Formát data následuje RFC 1123. Další informace najdete v tématu Znázornění hodnot Date-Time v hlavičkách.

Jakákoli operace, která upraví objekt blob, včetně aktualizace metadat nebo vlastností objektu blob, změní čas poslední změny objektu blob.
ETag ETag objektu blob. Pokud je verze požadavku 2011-08-18 nebo novější, hodnota ETag bude v uvozovkách.
x-ms-request-id Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Označuje verzi Blob service, která se používá k provedení požadavku. Tato hlavička se vrátí pro požadavky na verzi 2009-09-19 a novější.

Tato hlavička se vrátí také pro anonymní požadavky bez zadané verze, pokud byl kontejner označen pro veřejný přístup pomocí verze z 19. 9. 2009 Blob service.
Date Hodnota data a času UTC vygenerovaná službou, která udává čas zahájení odpovědi.
x-ms-client-request-id Tato hlavička se používá k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě hlavičky, pokud se nachází v požadavku a hodnota je nejvíce x-ms-client-request-id 1 024 viditelných znaků ASCII. Pokud hlavička v požadavku není, nebude tato hlavička x-ms-client-request-id v odpovědi k dispozici.

Text odpovědi

Žádné

Autorizace

Tuto operaci může provést vlastník účtu nebo kdokoli, kdo používá sdílený přístupový podpis s oprávněním ke čtení objektu blob. Pokud je seznam ACL kontejneru nastavený tak, aby povoll anonymní přístup, může tuto operaci volat libovolný klient.

Poznámky

Žádné

Viz také

Autorizace požadavků na Azure Storage
Stavové a chybové kódy
Kódy chyb služby Blob Service