Nastavení značek objektů blob

Článek
08/16/2021
4 min ke čtení

Operace nastaví uživatelem definované značky pro zadaný objekt blob jako jeden nebo Set Blob Tags více párů klíč-hodnota.

Žádost

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

Identifikátor URI požadavku metody PUT	Verze PROTOKOLU HTTP
`https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags` `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 je možné zadat následující další parametry.

Parametr	Popis
`versionid`	Volitelné pro verze z 12. 12. 2019 a novější. Parametr versionid je neprůhledná hodnota, která pokud je k dispozici, 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. 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.
`Content-Length`	Povinná hodnota. Délka obsahu požadavku v bajtech. Všimněte si, že tato hlavička odkazuje na délku obsahu dokumentu značek, nikoli na samotný objekt blob.
`Content-Type`	Povinná hodnota. Hodnota této hlavičky by měla být application/xml. charset=UTF-8.
`Content-MD5`	Nepovinný parametr. Hodnota hash MD5 obsahu požadavku. Tato hodnota hash se používá k ověření integrity obsahu požadavku během přenosu. Pokud se tyto dvě hash neshodují, operace selže s kódem chyby 400 (Chybný požadavek). Všimněte si, že tato hlavička je přidružená k obsahu požadavku, a ne k obsahu samotného objektu blob.
`x-ms-content-crc64`	Nepovinný parametr. Hodnota hash CRC64 obsahu požadavku. Tato hodnota hash se používá k ověření integrity obsahu požadavku během přenosu. Pokud se tyto dvě hash neshodují, operace selže s kódem chyby 400 (Chybný požadavek). Všimněte si, že tato hlavička je přidružená k obsahu požadavku, a ne k obsahu samotného objektu blob. Pokud jsou k dispozici hlavičky i , požadavek selže s kódem chyby `Content-MD5` `x-ms-content-crc64` 400 (Chybný požadavek).
`x-ms-lease-id:<ID>`	Vyžaduje se, pokud má objekt blob aktivní zapůjčení. Pokud chcete tuto operaci provést u objektu blob s aktivním zapůjčením, zadejte platné ID zapůjčení pro tuto hlavičku. Pokud v požadavku není zadané platné ID zapůjčení, operace selže se stavový kódem 403 (Zakázáno).
`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 podporuje x-ms-if-tags podmíněnou hlavičku pro nastavení značek objektů 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

Text požadavku má následující formát:

<?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>

Text požadavku musí být dokument UTF-8 XML ve správném formátu, který obsahuje sadu značek představující značky objektu blob.

Sada značek může obsahovat nejvíce 10 značek. U klíčů a hodnot značek se rozlišují malá a velká písmena. Klíče značek musí mít 1 až 128 znaků a hodnoty značek musí být v rozmezí 0 až 256 znaků. Mezi platné znaky klíče značky a hodnoty patří:

Malá a velká písmena (a–z, A–Z)
Číslice (0–9)
Mezera ( )
Plus (+), minus (-), tečka (.), solidus (/), dvojtečka (:), rovná se (=) a podtržítko (_)

Odpověď

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

Stavový kód

Úspěšná operace vrátí stavový kód 204 (Bez obsahu).

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-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.
`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 volat vlastník účtu a kdokoli, kdo má sdílený přístupový podpis s oprávněním ke značce objektu blob (oprávnění t SAS).

Kromě toho mohou tuto operaci provádět uživatelé RBAC Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write s oprávněním .

Poznámky

Operace Set Blob Tags je podporována v REST API verze 2019-12-12 a novější.

Operace Set Blob Tags přepíše všechny existující značky objektu blob. Pokud chcete z objektu blob odebrat všechny značky, Set Blob Tags odešlete požadavek s prázdným <TagSet> objektem .

Tato operace ne aktualizuje ETag ani čas poslední změny objektu blob. U archivovaného objektu blob je možné nastavit značky.

Služba úložiště udržuje silnou konzistenci mezi objektem blob a jeho značkami. Změny značek objektů BLOB jsou okamžitě viditelné pro následné Get Blob Tags operace v objektu BLOB. Sekundární index je však nakonec konzistentní; změny značek objektu BLOB se nemusí hned zobrazit na Find Blobs by Tags operacích.

Pokud požadavek poskytuje neplatné značky, Blob service vrátí stavový kód 400 (chybný požadavek).

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