Získat značky objektu BLOB

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

Tato Get Blob Tags operace vrátí všechny uživatelsky definované značky pro zadaný objekt blob, verzi nebo snímek.

Žádost

Get Blob TagsPožadavek může být vytvořen následujícím způsobem. Doporučuje se protokol HTTPS. Nahraďte MyAccount názvem vašeho účtu úložiště:

ZÍSKAT identifikátor URI žádosti o metodu Verze protokolu HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags

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

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

Parametry identifikátoru URI

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

Parametr Popis
snapshot Nepovinný parametr. Parametr snímku je neprůhledná DateTime hodnota, která je-li k dispozici, určuje snímek objektu blob, který se má načíst. Další informace o práci s snímky objektů BLOB najdete v tématu vytvoření snímku objektu BLOB .
versionid Volitelné pro verze 2019-12-12 a novější. Parametr VersionID je neprůhledná DateTime hodnota, která je-li k dispozici, určuje verzi objektu blob, který se má načíst.
timeout Nepovinný parametr. timeoutParametr se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby BLOB Service.

Hlavičky požadavku

V následující tabulce jsou popsány povinné a volitelné hlavičky požadavků.

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ů pro 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ů pro Azure Storage.
x-ms-version Vyžaduje se pro všechny autorizované požadavky, volitelné pro anonymní žádosti. Určuje verzi operace, která se má použít pro tento požadavek. další informace najdete v tématu správa verzí pro služby Azure Storage.
x-ms-lease-id:<ID> Vyžaduje se, pokud má objekt BLOB aktivní zapůjčení.

Chcete-li provést tuto operaci u objektu BLOB s aktivním zapůjčením, zadejte platné ID zapůjčení pro tuto hlavičku. Pokud není v žádosti zadáno platné ID zapůjčení, operace se nezdaří se stavovým kódem 403 (zakázáno).
x-ms-client-request-id Nepovinný parametr. Poskytuje klienta vygenerovanou neprůhlednou hodnotu s 1 KiB limitem, který je zaznamenán v protokolech analýzy, pokud je povoleno protokolování služby Storage Analytics. 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 o protokolování Analýza úložiště a protokolování Azure: použití protokolů ke sledování požadavků Storage.

Tato operace podporuje x-ms-if-tags podmíněnou hlavičku pro získání značek 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.

Text požadavku

Žádné

Odpověď

Odpověď zahrnuje stavový kód HTTP, hlavičky odpovědí a tělo odpovědi.

Stavový kód

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

Informace o stavových kódech naleznete v tématu stav 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šechna standardní záhlaví jsou v souladu se specifikací protokolu HTTP/1.1.

Hlavička odpovědi Popis
Content-Type application/xml
Content-Length Velikost vráceného dokumentu XML, v bajtech
x-ms-request-id Tato hlavička jednoznačně identifikuje požadavek, který se provedl, a dá se použít k řešení potíží s žádostí. Další informace najdete v tématu řešení potíží s operacemi rozhraní API.
x-ms-version Určuje verzi Blob service, která se používá ke spuštění žádosti.
Date Hodnota data a času UTC vygenerovaná službou, která indikuje čas, kdy byla odpověď iniciována.
x-ms-client-request-id Tato hlavička se dá použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota tohoto záhlaví je rovna hodnotě x-ms-client-request-id záhlaví, pokud se nachází v požadavku a hodnota je nejvýše 1024 viditelných znaků ASCII. Pokud x-ms-client-request-id Hlavička v požadavku není, tato hlavička nebude v odpovědi přítomna.

Tělo odpovědi

Formát textu odpovědi je následující:

<?xml version="1.0" encoding="utf-8"?>  
<Tags>  
    <TagSet>  
        <Tag>  
            <Key>tag-name-1</Key>  
            <Value>tag-value-1</Value>  
        </Tag>  
        <Tag>  
            <Key>tag-name-2</Key>  
            <Value>tag-value-2</Value>  
        </Tag>  
    </TagSet>  
</Tags>

Tělo odpovědi je dobře vytvořený dokument XML UTF-8, který představuje všechny značky uložené v objektu BLOB.

Autorizace

Tuto operaci může volat vlastník účtu a kdokoli se sdíleným přístupovým podpisem, který má oprávnění k značkám objektu BLOB ( t oprávnění SAS).

Kromě toho Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read může tato operace provádět uživatelé RBAC s oprávněním.

Poznámky

Tato Get Blob Tags operace je podporovaná ve verzi REST API 2019-12-12 a novější.

V odpovědi není zaručeno řazení značek.

Služba úložiště udržuje silnou konzistenci mezi objektem BLOB a jeho značkami, ale sekundární index je nakonec konzistentní. Značky mohou být viditelné v reakci na, aby byly Get Blob Tags viditelné Find Blobs by Tags operace.

Viz také

Správa a vyhledávání dat ve službě Azure Blob Storage s využitím indexu objektů blob
Autorizovat požadavky na Azure Storage
Stavové a chybové kódy
Kódy chyb služby Blob Service