Nastavení značek objektů blob

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žívat protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště:

Parametry identifikátoru URI

V identifikátoru URI požadavku můžete zadat následující další parametry:

Hlavičky požadavku

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

Tato operace podporuje podmíněnou hlavičku x-ms-if-tags 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 dokument XML UTF-8 ve správném formátu a musí obsahovat sadu značek, která představuje značky objektu blob.

Sada značek nesmí obsahovat více než 10 značek. V klíčích a hodnotách 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í 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 Kódy stavu a 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.

Text odpovědi

Žádné

Autorizace

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

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ě:

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