Nastavení značek objektů blob

  • Článek

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

Žádost

Požadavek Set Blob Tags může být vytvořen následujícím způsobem. Doporučujeme použít 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 můžete zadat následující další parametry:

Parametr Popis
versionid Volitelné pro verzi 2019-12-12 a novější. Parametr versionid je neprůselná DateTime hodnota, která při výskytu určuje verzi objektu 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 Storage.

Hlavičky požadavku

Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:

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ů do služby 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ů do služby Azure Storage.
x-ms-version Povinné pro všechny autorizované žá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.
Content-Length Povinná hodnota. Délka obsahu požadavku v bajtech. 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ě hodnoty hash neshodnou, operace selže s kódem chyby 400 (Chybný požadavek).

Tato hlavička je přidružená k obsahu požadavku, nikoli 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ě hodnoty hash neshodnou, operace selže s kódem chyby 400 (Chybný požadavek).

Tato hlavička je přidružená k obsahu požadavku, nikoli k obsahu samotného objektu blob.

Pokud jsou k dispozici hlavičky i Content-MD5x-ms-content-crc64 , požadavek selže s kódem chyby 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 s objektem 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ým kódem 403 (Zakázáno).
x-ms-client-request-id Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování Azure Blob Storage.

Tato operace podporuje x-ms-if-tags podmíněné záhlaví 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 Storage.

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 ve správném formátu dokumentu XML UTF-8 a musí obsahovat sadu značek, která představuje značky objektu blob.

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

  • Malá a velká písmena (a-z, A–Z)
  • Číslice (0–9)
  • Mezera ( )
  • Plus (+), minus (-), tečka (.), lomítko (/), 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).

Další informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

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

Hlavička odpovědi Description
x-ms-request-id Jedineč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 Verze služby Blob Storage, která se použila ke spuštění požadavku.
Date Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
x-ms-client-request-id Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku, a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, nebude v odpovědi.

Text odpovědi

Žádné

Autorizace

Při volání jakékoli operace přístupu k datům ve službě Azure Storage se vyžaduje autorizace. Operaci můžete autorizovat, Set Blob Tags jak je popsáno níže.

Azure Storage podporuje autorizaci požadavků na data objektů blob pomocí Microsoft Entra ID. S Microsoft Entra ID můžete pomocí řízení přístupu na základě role v Azure (Azure RBAC) udělit oprávnění k objektu zabezpečení. Objektem zabezpečení může být uživatel, skupina, instanční objekt aplikace nebo spravovaná identita Azure. Objekt zabezpečení je ověřen Microsoft Entra ID, aby vrátil token OAuth 2.0. Token se pak dá použít k autorizaci požadavku na službu Blob Service.

Další informace o autorizaci pomocí Microsoft Entra ID najdete v tématu Autorizace přístupu k objektům blob pomocí Microsoft Entra ID.

Oprávnění

Níže jsou uvedené akce RBAC potřebné k volání operace Microsoft Entra uživatele, skupiny nebo instančního Set Blob Tags objektu a předdefinované role Azure RBAC s nejnižšími oprávněními, která zahrnuje tuto akci:

Další informace o přiřazování rolí pomocí Azure RBAC najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Poznámky

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

U účtů s povoleným hierarchickým oborem Set Blob Tags názvů se operace nepodporuje, protože pro účty hierarchického oboru názvů se nepodporují značky objektů blob.

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

Tato operace neaktualizuje značku 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é při následných Get Blob Tags operacích s objektem blob. Sekundární index je ale nakonec konzistentní. Změny značek objektu blob nemusí být okamžitě viditelné pro Find Blobs by Tags operace.

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

Fakturace

Žádosti o ceny můžou pocházet od klientů, kteří používají rozhraní BLOB Storage API, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny Služby Azure Storage. Tyto požadavky načítají poplatky za transakci. Typ transakce ovlivňuje způsob účtování poplatku za účet. Například transakce čtení se načítají do jiné kategorie fakturace než transakce zápisu. Následující tabulka ukazuje kategorii fakturace pro Set Blob Tags žádosti založené na typu účtu úložiště:

Operace Typ účtu úložiště Kategorie fakturace
Nastavení značek objektů blob Objekt blob bloku úrovně Premium
Standard pro obecné účely v2		 Další operace
Nastavení značek objektů blob Standard pro obecné účely v1 Operace zápisu

Informace o cenách pro zadanou kategorii fakturace najdete v tématu Azure Blob Storage Ceny.

Viz také

Správa a vyhledání dat služby Blob Storage pomocí značek indexu objektů blob
Autorizace žádostí do Služby Azure Storage
Stavové kódy a kódy chyb
Kódy chyb služby Blob Storage