Nastavení vlastností objektu blob

  • Článek

Operace Set Blob Properties nastaví systémové vlastnosti objektu blob.

Žádost

Požadavek Set Blob Properties 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ě:

Identifikátor URI požadavku metody PUT Verze PROTOKOLU HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=properties HTTP/1.1

Identifikátor URI služby emulovaného úložiště

Když vytváříte požadavek na službu emulovaného úložiště, zadejte název hostitele emulátoru a port služby Blob Storage a 127.0.0.1:10000pak název emulovaného účtu úložiště:

Identifikátor URI požadavku metody PUT Verze PROTOKOLU HTTP
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties HTTP/1.1

Další informace najdete v tématu Použití emulátoru Azurite pro vývoj v místním úložišti Azure Storage.

Parametry identifikátoru URI

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

Parametr Popis
timeout Nepovinný parametr. Parametr se timeout vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Blob Storage.

Hlavičky požadavku (všechny typy objektů blob)

Následující tabulka popisuje požadované a volitelné hlavičky požadavků pro všechny typy objektů blob.

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 Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-blob-cache-control Nepovinný parametr. Upraví řídicí řetězec mezipaměti pro objekt blob.

Pokud tato vlastnost není v požadavku zadaná, vymaže se vlastnost objektu blob. Další volání funkce Získat vlastnosti objektu blob nevrátí tuto vlastnost, pokud není u objektu blob znovu explicitně nastavená.
x-ms-blob-content-type Nepovinný parametr. Nastaví typ obsahu objektu blob.

Pokud tato vlastnost není v požadavku zadaná, vymaže se vlastnost objektu blob. Další volání funkce Získat vlastnosti objektu blob nevrátí tuto vlastnost, pokud není u objektu blob znovu explicitně nastavená.
x-ms-blob-content-md5 Nepovinný parametr. Nastaví hodnotu hash MD5 objektu blob.

Pokud tato vlastnost není v požadavku zadaná, vymaže se vlastnost objektu blob. Další volání funkce Získat vlastnosti objektu blob nevrátí tuto vlastnost, pokud není u objektu blob znovu explicitně nastavená.
x-ms-blob-content-encoding Nepovinný parametr. Nastaví kódování obsahu objektu blob.

Pokud tato vlastnost není v požadavku zadaná, vymaže se vlastnost objektu blob. Další volání funkce Získat vlastnosti objektu blob nevrátí tuto vlastnost, pokud není u objektu blob znovu explicitně nastavená.
x-ms-blob-content-language Nepovinný parametr. Nastaví jazyk obsahu objektu blob.

Pokud tato vlastnost není v požadavku zadaná, vymaže se vlastnost objektu blob. Další volání funkce Získat vlastnosti objektu blob nevrátí tuto vlastnost, pokud není u objektu blob znovu explicitně nastavená.
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í této hlavičky.
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.
x-ms-blob-content-disposition Nepovinný parametr. Nastaví hlavičku objektu Content-Disposition blob. K dispozici pro verzi 2013-08-15 a novější.

Pole Content-Disposition hlavičky odpovědi sděluje další informace o tom, jak zpracovat datovou část odpovědi, a dá se použít k připojení dalších metadat. Pokud je například nastavená hodnota attachment, znamená to, že by uživatelský agent neměl zobrazovat odpověď, ale místo toho zobrazovat dialogové okno Uložit jako s jiným názvem souboru, než je zadaný název objektu blob.

Odpověď z operací Get Blob (Získání objektu blob ) a Get Blob Properties (Získat objekt blob) obsahuje hlavičku content-disposition .
Origin Nepovinný parametr. Určuje původ, ze kterého je žádost vystavena. Přítomnost této hlavičky má za následek, že odpověď obsahuje hlavičky sdílení prostředků mezi zdroji. Další informace najdete v tématu Podpora CORS (sdílení prostředků mezi zdroji) pro služby Azure Storage.

Tato operace také podporuje použití podmíněných hlaviček k nastavení vlastností 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 Storage.

Hlavičky požadavku (jenom objekty blob stránky)

Následující tabulka popisuje hlavičky požadavků, které se vztahují pouze na operace s objekty blob stránky:

Hlavička požadavku Popis
x-ms-blob-content-length: byte value Nepovinný parametr. Změní velikost objektu blob stránky na zadanou velikost. Pokud je zadaná hodnota menší než aktuální velikost objektu blob, vymažou se všechny objekty blob stránky s hodnotami, které jsou větší než zadaná hodnota.

Tuto vlastnost nejde použít ke změně velikosti objektu blob bloku nebo doplňovacího objektu blob. Nastavení této vlastnosti pro objekt blob bloku nebo doplňovací objekt blob vrátí stavový kód 400 (Chybný požadavek).
x-ms-sequence-number-action: {max, update, increment} Volitelné, ale vyžaduje se, x-ms-blob-sequence-number pokud je pro požadavek nastavená hlavička. Tato vlastnost se vztahuje pouze na objekty blob stránky.

Tato vlastnost určuje, jak má služba upravit pořadové číslo objektu blob. Zadejte jednu z následujících možností pro tuto vlastnost:

- max: Nastaví pořadové číslo na vyšší z hodnoty zahrnuté do požadavku a hodnoty aktuálně uložené pro objekt blob.
- update: Nastaví pořadové číslo na hodnotu, která je součástí požadavku.
- increment: Zvýší hodnotu pořadového čísla o 1. Pokud zadáváte tuto možnost, nezahrnujte .x-ms-blob-sequence-number header Vrátí se tak stavový kód 400 (Chybný požadavek).
x-ms-blob-sequence-number: <num> Volitelné, ale vyžaduje se, x-ms-sequence-number-action pokud je vlastnost nastavená na max nebo update. Tato vlastnost se vztahuje pouze na objekty blob stránky.

Vlastnost nastaví pořadové číslo objektu blob. Pořadové číslo je uživatelsky řízená vlastnost, kterou můžete použít ke sledování požadavků a správě problémů se souběžností. Další informace najdete v operaci Put Page .

Pomocí této vlastnosti společně s x-ms-sequence-number-action můžete aktualizovat pořadové číslo objektu blob na zadanou hodnotu nebo vyšší z hodnot zadaných požadavkem nebo aktuálně uložených v objektu blob. Tato hlavička by neměla být zadána, pokud x-ms-sequence-number-action je nastavena na incrementhodnotu . V takovém případě služba automaticky zvýší pořadové číslo o jednu.

Chcete-li nastavit pořadové číslo na hodnotu podle vašeho výběru, musí být tato vlastnost zadána v požadavku společně s x-ms-sequence-number-action.

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).

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.

Syntax Description
ETag Obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Storage . Pokud je verze požadavku 2011-08-18 nebo novější, je hodnota ETag uzavřena v uvozovkách.
Last-Modified Datum a čas poslední změny objektu blob. Formát data se řídí dokumentem RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích.

Každá operace zápisu v objektu blob (včetně aktualizací metadat nebo vlastností objektu blob) změní čas poslední změny objektu blob.
x-ms-blob-sequence-number Pokud je objekt blob objektem blob stránky, vrátí se aktuální pořadové číslo objektu blob s touto hlavičkou.
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 Označuje verzi služby Blob Storage, která se použila ke spuštění požadavku. Tato hlavička se vrátí pro požadavky, které byly provedeny ve verzi 2009-09-19 a novější.
Date Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
Access-Control-Allow-Origin Vrátí se, pokud požadavek obsahuje hlavičku Origin a CORS je povolený s odpovídajícím pravidlem. Pokud existuje shoda, vrátí tato hlavička hodnotu hlavičky žádosti o původ.
Access-Control-Expose-Headers Vrátí se, pokud požadavek obsahuje hlavičku Origin a CORS je povolený s odpovídajícím pravidlem. Vrátí seznam hlaviček odpovědi, které mají být zpřístupněny klientovi nebo vystaviteli požadavku.
Access-Control-Allow-Credentials Vrátí se, pokud požadavek obsahuje hlavičku Origin a CORS je povolený s odpovídajícím pravidlem, které neumožňuje všechny zdroje. Hlavička bude nastavena na true.
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 Properties 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 Properties 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

Sémantika pro aktualizaci vlastností objektu blob je následující:

  • Pořadové číslo objektu blob stránky se aktualizuje pouze v případě, že požadavek splňuje některou z následujících podmínek:

    • Požadavek nastaví x-ms-sequence-number-action hodnotu na max nebo updatea určuje hodnotu pro hlavičku x-ms-blob-sequence-number .

    • Požadavek nastaví hodnotu x-ms-sequence-number-action na increment, což znamená, že služba by měla pořadové číslo zvýšit o jednu.

  • Velikost objektu blob stránky se změní jenom v případě, že požadavek určuje hodnotu pro hlavičku x-ms-content-length .

  • Pokud chcete změnit velikost objektu blob stránky v účtu služby Premium Storage, nesmí nová velikost překročit délku obsahu povolenou stávající úrovní. Před změnou velikosti objektu blob zavolejte úroveň Set Blob . Seznam úrovní a povolené délky obsahu najdete v tématu Vysoce výkonné úložiště Premium a spravované disky pro virtuální počítače.

  • Pokud požadavek nastaví pouze x-ms-blob-sequence-number nebo x-ms-content-length, ostatní vlastnosti objektu blob se nezmění.

  • Pokud je v požadavku nastavena jedna nebo více následujících vlastností, jsou všechny vlastnosti nastaveny společně. Pokud se pro vlastnost nezadá hodnota, když je nastavená alespoň jedna z nich, vymaže se tato vlastnost objektu blob.

    • x-ms-blob-cache-control
    • x-ms-blob-content-type
    • x-ms-blob-content-md5
    • x-ms-blob-content-encoding
    • x-ms-blob-content-language
    • x-ms-blob-content-disposition

Poznámka

U sdíleného přístupového podpisu (SAS) můžete přepsat určité vlastnosti uložené pro objekt blob zadáním parametrů dotazu jako součásti sdíleného přístupového podpisu. Mezi tyto vlastnosti patří cache-controlvlastnosti , content-type, content-encoding, content-languagea content-disposition . Další informace najdete v tématu Vytvoření SAS služby.

Fakturace

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

Operace Typ účtu úložiště Kategorie fakturace
Nastavení vlastností objektu blob Objekt blob bloku úrovně Premium
Standard pro obecné účely v2		 Další operace
Nastavení vlastností objektu 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é