Put Block List

  • Článek

Operace Put Block List zapíše objekt blob zadáním seznamu ID bloků, které tvoří objekt blob. Aby se blok zapisoval jako součást objektu blob, musí být úspěšně zapsán na server v předchozí operaci Put Block .

Můžete volat Put Block List aktualizaci objektu blob tak, že nahrajete jenom ty bloky, které se změnily, a pak potvrdíte nové a existující bloky dohromady. Můžete to provést tak, že určíte, jestli chcete potvrdit blok ze seznamu potvrzených bloků nebo ze seznamu nepotvrzených bloků, nebo jestli chcete potvrdit naposledy nahranou verzi bloku podle toho, do kterého seznamu patří.

Žádost

Požadavek můžete sestavit Put Block List 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=blocklist HTTP/1.1

Žádost o službu 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 Service jako 127.0.0.1:10000a pak 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=blocklist HTTP/1.1

Emulátor úložiště podporuje pouze objekty blob o velikosti až 2 gibibajtů (GiB).

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

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 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.
Content-Length Povinná hodnota. Délka obsahu požadavku v bajtech Tato hlavička odkazuje na délku obsahu seznamu bloků, nikoli na samotný objekt blob.
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 neshodí, 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 neshodí, 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 Content-MD5 i x-ms-content-crc64, požadavek selže s chybou 400 (chybný požadavek).

Tato hlavička je podporovaná ve verzi 2019-02-02 a novějších.
x-ms-blob-cache-control Nepovinný parametr. Nastaví ovládací prvek mezipaměti objektu blob. Pokud je tato vlastnost zadaná, uloží se s objektem blob a vrátí se s požadavkem na čtení.

Pokud vlastnost není u požadavku zadaná, vymaže se pro objekt blob, pokud je požadavek úspěšný.
x-ms-blob-content-type Nepovinný parametr. Nastaví typ obsahu objektu blob. Pokud je tato vlastnost zadaná, uloží se spolu s objektem blob a vrátí se s požadavkem na čtení.

Pokud typ obsahu není zadaný, nastaví se na výchozí typ, což je application/octet-stream.
x-ms-blob-content-encoding Nepovinný parametr. Nastaví kódování obsahu objektu blob. Pokud je tato vlastnost zadaná, uloží se spolu s objektem blob a vrátí se s požadavkem na čtení.

Pokud vlastnost není u požadavku zadaná, vymaže se pro objekt blob, pokud je požadavek úspěšný.
x-ms-blob-content-language Nepovinný parametr. Nastaví jazyk obsahu objektu blob. Pokud je tato vlastnost zadaná, uloží se spolu s objektem blob a vrátí se s požadavkem na čtení.

Pokud vlastnost není u požadavku zadaná, vymaže se pro objekt blob, pokud je požadavek úspěšný.
x-ms-blob-content-md5 Nepovinný parametr. Hodnota hash MD5 obsahu objektu blob. Tato hodnota hash se neověřuje, protože hodnoty hash jednotlivých bloků byly ověřeny při nahrání každého z nich.

Operace Get Blob vrátí hodnotu této hlavičky v hlavičce odpovědi Content-MD5.

Pokud tato vlastnost není u požadavku zadaná, vymaže se pro objekt blob, pokud je požadavek úspěšný.
x-ms-meta-name:value Nepovinný parametr. Uživatelem definované páry název-hodnota, které jsou přidružené k objektu blob.

Od verze 2009-09-19 musí názvy metadat dodržovat pravidla pojmenování pro identifikátory jazyka C#.
x-ms-encryption-scope Nepovinný parametr. Označuje obor šifrování, který se má použít k šifrování objektu blob. Tato hodnota se musí shodovat s oborem šifrování, který se používá k šifrování všech potvrzených bloků. Tato hlavička je podporovaná ve verzi 2019-02-02 a novějších.
x-ms-encryption-context Nepovinný parametr. Výchozí hodnota je Prázdná. Pokud je hodnota nastavená, nastaví se metadata systému objektů blob. Maximální délka-1024. Platí pouze v případě, že je pro účet povolený hierarchický obor názvů. Tato hlavička je podporovaná ve verzích 2021-08-06 a novějších.
x-ms-tags Nepovinný parametr. Nastaví v objektu blob zakódované značky s kódováním řetězce dotazu. Další informace najdete v části Poznámky . Podporováno ve verzi 2019-12-12 a novější.
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ý se zaznamená v protokolech analýzy, když je nakonfigurované protokolování analýzy úložiště. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá.
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 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, tato hlavička indikuje, že by uživatelský agent neměl zobrazovat odpověď, ale místo toho by měl zobrazit dialogové okno Uložit jako.

Odpověď z operací Get Blob a Get Blob Properties obsahuje hlavičku content-disposition.
x-ms-access-tier Nepovinný parametr. Verze 2018-11-09 a novější. Označuje úroveň, která se má nastavit v objektu blob. Pro objekty blob bloku se tato hlavička podporuje v účtech blob storage nebo účtech pro obecné účely verze 2018-11-09 a novější. Platné hodnoty pro úrovně objektů blob bloku jsou Hot, Cool, Colda Archive. Poznámka: Cold Úroveň se podporuje pro verzi 2021-12-02 a novější. Podrobné informace o vrstvení objektů blob bloku najdete v tématu Horká, studená a archivní vrstva úložiště.
x-ms-immutability-policy-until-date Verze 2020-06-12 a novější. Určuje datum uchování, které se pro objekt blob nastaví. Jedná se o datum, do kterého je možné objekt blob chránit před úpravami nebo odstraněním. Používá RFC1123 formát.
x-ms-immutability-policy-mode Verze 2020-06-12 a novější. Určuje režim zásad neměnnosti, který se má pro objekt blob nastavit. Platné hodnoty jsou unlocked a locked. Hodnota unlocked označuje, že uživatelé můžou zásadu změnit zvýšením nebo snížením data uchování do doby uchování . Hodnota locked označuje, že tyto akce jsou zakázány.
x-ms-legal-hold Verze 2020-06-12 a novější. Určuje blokování z právních důvodů, které se má nastavit pro objekt blob. Platné hodnoty jsou true a false.
x-ms-expiry-option Nepovinný parametr. Verze 2023-08-03 a novější. Určuje datum vypršení platnosti žádosti, viz ExpiryOption. Tato hlavička je platná pro účty s povoleným hierarchickým oborem názvů.
x-ms-expiry-time Nepovinný parametr. Verze 2023-08-03 a novější. Určuje čas, kdy je nastavena platnost objektu blob. Formát data vypršení platnosti se liší podle x-ms-expiry-option. Další informace najdete v tématu ExpiryOption. Tato hlavička je platná pro účty s povoleným hierarchickým oborem názvů.

Pokud expiryTime požadavek neobsahuje novou hodnotu , nevymaže se objekt blob, který už je v objektu blob. expiryTime

Tato operace také podporuje použití podmíněných hlaviček k potvrzení seznamu blokovaných 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 (šifrovací klíče poskytnuté zákazníkem)

Od verze 2019-02-02 můžete v požadavku na šifrování objektu blob pomocí klíče poskytnutého zákazníkem zadat následující hlavičky. Šifrování pomocí klíče poskytnutého zákazníkem (a odpovídající sady hlaviček) je volitelné.

Hlavička požadavku Popis
x-ms-encryption-key Povinná hodnota. Šifrovací klíč AES-256 s kódováním Base64.
x-ms-encryption-key-sha256 Povinná hodnota. Hodnota hash SHA256 s kódováním Base64 šifrovacího klíče.
x-ms-encryption-algorithm: AES256 Povinná hodnota. Určuje algoritmus, který se má použít k šifrování. Hodnota této hlavičky musí být AES256.

Text požadavku

V textu požadavku můžete zadat seznam bloků, který má Blob Storage zkontrolovat u požadovaného bloku. Tímto způsobem můžete aktualizovat existující objekt blob vložením, nahrazením nebo odstraněním jednotlivých bloků místo opětovného načtení celého objektu blob. Po nahrání změněného bloku nebo bloků můžete potvrdit novou verzi objektu blob tím, že potvrdíte nové bloky společně s existujícími bloky, které chcete zachovat.

Pokud chcete aktualizovat objekt blob, můžete určit, že služba hledá ID bloku v seznamu potvrzených bloků, v seznamu nepotvrzených bloků nebo v seznamu nepotvrzených bloků a pak v seznamu potvrzených bloků. Pokud chcete určit, který přístup se má použít, zadejte ID bloku, které se nachází v příslušném elementu XML v textu požadavku, a to následujícím způsobem:

  • Zadejte ID bloku v elementu Committed , aby služba Blob Storage měla pojmenovaný blok hledat pouze v seznamu potvrzených bloků. Pokud se blok nenajde v seznamu potvrzených bloků, nezapíše se jako součást objektu blob a Blob Storage vrátí stavový kód 400 (chybný požadavek).

  • Zadejte ID bloku v elementu Uncommitted , abyste určili, že by služba Blob Storage měla pojmenovaný blok hledat pouze v seznamu nepotvrzených bloků. Pokud se blok nenajde v seznamu nepotvrzených bloků, nezapíše se jako součást objektu blob a Blob Storage vrátí stavový kód 400 (chybný požadavek).

  • Zadejte ID bloku v elementu Latest , abyste určili, že by služba Blob Storage měla nejprve prohledat nepotvrzený seznam bloků. Pokud se blok najde v seznamu nepotvrzených, je tato verze bloku nejnovější a měla by se zapsat do objektu blob. Pokud se blok v seznamu nepotvrzených nenajde, měla by služba vyhledat pojmenovaný blok v seznamu potvrzených bloků, a pokud ho najde, zapsat ho do objektu blob.

Text požadavku pro tuto verzi Put Block List používá následující formát XML:

<?xml version="1.0" encoding="utf-8"?>  
<BlockList>  
  <Committed>first-base64-encoded-block-id</Committed>  
  <Uncommitted>second-base64-encoded-block-id</Uncommitted>  
  <Latest>third-base64-encoded-block-id</Latest>  
  ...  
</BlockList>

Ukázkový požadavek

Pro předvedení Put Block Listpředpokládejme, že jste nahráli tři bloky, které teď chcete potvrdit. Následující příklad potvrdí nový objekt blob tím, že indikuje, že by se měla použít nejnovější verze každého uvedeného bloku. Není nutné vědět, jestli tyto bloky již byly potvrzeny.

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=blocklist HTTP/1.1  
  
Request Headers:  
x-ms-date: Wed, 31 Aug 2011 00:17:43 GMT  
x-ms-version: 2011-08-18  
Content-Type: text/plain; charset=UTF-8  
Authorization: SharedKey myaccount:DJ5QZSVONZ64vAhnN/wxcU+Pt5HQSLAiLITlAU76Lx8=  
Content-Length: 133  
  
Request Body:  
<?xml version="1.0" encoding="utf-8"?>  
<BlockList>  
  <Latest>AAAAAA==</Latest>  
  <Latest>AQAAAA==</Latest>  
  <Latest>AZAAAA==</Latest>  
</BlockList>

Dále předpokládejme, že chcete objekt blob aktualizovat. Nový objekt blob má následující změny:

  • Nový blok s ID ANAAAA== Tento blok musí být nejprve nahrán s voláním bloku Put Block a zobrazuje se v seznamu nepotvrzených bloků až do volání Put Block Listmetody .

  • Aktualizovaná verze bloku s ID AZAAAA==. Tento blok musí být nejprve nahrán s voláním bloku Put Block a zobrazuje se v seznamu nepotvrzených bloků až do volání Put Block Listmetody .

  • Odebrání bloku s ID AAAAAA== Vzhledem k tomu, že tento blok není součástí dalšího volání Put Block List, odebere se z objektu blob.

Následující příklad ukazuje volání Put Block List , které aktualizuje objekt blob:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=blocklist HTTP/1.1  
  
Request Headers:  
x-ms-date: Wed, 31 Aug 2009 00:17:43 GMT  
x-ms-version: 2011-08-18  
Content-Type: text/plain; charset=UTF-8  
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:DJ5QZSVONZ64vAhnN/wxcU+Pt5HQSLAiLITlAU76Lx8=  
Content-Length: 133  
  
Request Body:  
<?xml version="1.0" encoding="utf-8"?>  
<BlockList>  
  <Uncommitted>ANAAAA==</Uncommitted>  
  <Committed>AQAAAA==</Committed>  
  <Uncommitted>AZAAAA==</Uncommitted>  
</BlockList>

Odpověď

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

Stavový kód

Úspěšná operace vrátí stavový kód 201 (Vytvořeno).

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.

Odpověď Popisy
ETag Značka entity obsahuje hodnotu, kterou může klient použít k provádění podmíněných GET/PUT operací pomocí hlavičky If-Match požadavku. Pokud je verze požadavku 2011-08-18 nebo novější, hodnota ETag je uzavřena v uvozovkách.
Last-Modified Datum a čas poslední změny objektu blob. Formát data odpovídá dokumentu RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích.

Každá operace, která změní objekt blob, včetně aktualizace metadat nebo vlastností objektu blob, změní čas poslední změny objektu blob.
Content-MD5 Vráceno, aby klient mohl zkontrolovat integritu obsahu zprávy. Tato hlavička odkazuje na obsah požadavku (v tomto případě na seznam bloků, a ne na samotný obsah objektu blob). Pro verzi 2019-02-02 a novější se tato hlavička vrátí jenom v případě, že požadavek má tuto hlavičku.
x-ms-content-crc64 Pro verzi 2019-02-02 a novější se tato hlavička vrátí, aby klient mohl zkontrolovat integritu obsahu zprávy. Tato hlavička odkazuje na obsah požadavku (v tomto případě na seznam bloků, a ne na samotný obsah objektu blob).

Tato hlavička se vrátí, když Content-md5 v požadavku není.
x-ms-request-id Jedinečně identifikuje požadavek, který byl proveden, a můžete 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žívá ke spuštění požadavku. Tato hlavička se vrátí pro požadavky, které jsou provedeny ve verzi 2009-09-19 a novější.
Date Hodnota data a času UTC vygenerovaná službou, která označuje, kdy byla odpověď inicializována.
x-ms-request-server-encrypted: true/false Verze 2015-12-11 a novější. Hodnota této hlavičky je nastavena na true , pokud je obsah požadavku úspěšně zašifrován pomocí zadaného algoritmu. V opačném případě je hodnota nastavena na falsehodnotu .
x-ms-encryption-key-sha256 Verze 2019-02-02 a novější. Tato hlavička se vrátí, pokud požadavek použil k šifrování klíč poskytnutý zákazníkem, aby klient mohl zajistit, že se obsah požadavku úspěšně zašifruje pomocí zadaného klíče.
x-ms-encryption-scope Verze 2019-02-02 a novější. Tato hlavička se vrátí, pokud požadavek použil obor šifrování, aby klient mohl zajistit, aby byl obsah požadavku úspěšně zašifrován pomocí oboru šifrování.
x-ms-version-id: <DateTime> Verze 2019-12-12 a novější. Vrátí neprůselnou DateTime hodnotu, která jednoznačně identifikuje objekt blob. Hodnota této hlavičky označuje verzi objektu blob a dá se použít v následných požadavcích na přístup k objektu blob.
x-ms-client-request-id Dá se použít k řešení potíží s požadavky a jejich 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í, není v odpovědi.

Ukázková odpověď

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
x-ms-content-crc64: 77uWZTolTHU  
Date: Sun, 25 Sep 2011 00:17:44 GMT  
ETag: “0x8CB172A360EC34B”  
Last-Modified: Sun, 25 Sep 2011 00:17:43 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>

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, Put Block List jak je popsáno níže.

Pokud požadavek určuje značky s hlavičkou x-ms-tags požadavku, volající musí splňovat požadavky na autorizaci operace Nastavit značky objektů blob .

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 Put Block List 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 Put Block List vynutí pořadí, ve kterém se mají bloky kombinovat, aby se vytvořil objekt blob.

Stejné ID bloku lze zadat vícekrát v seznamu bloků. Pokud je ID bloku zadané vícekrát, představuje rozsah bajtů v každém z těchto umístění v seznamu blokovaných pro konečný potvrzený objekt blob. Pokud se ID bloku v seznamu zobrazí více než jednou, musí být obě instance ID bloku zadány ve stejném seznamu blokovaných. Jinými slovy, obě instance musí být zadány v elementu Committed , elementu Uncommitted nebo elementu Latest .

Pomocí Put Block Listnástroje můžete upravit existující objekt blob vložením, aktualizací nebo odstraněním jednotlivých bloků, aniž byste museli znovu nahrát celý objekt blob. Pokud chcete vytvořit nový objekt blob nebo aktualizovat obsah existujícího objektu blob, můžete zadat ID bloků z aktuálního seznamu potvrzených i nepotvrzených bloků. Tímto způsobem můžete aktualizovat objekt blob zadáním několika nových bloků ze seznamu nepotvrzených bloků a ostatních ze seznamu potvrzených bloků, které už jsou součástí existujícího objektu blob.

Pokud je v elementu Latest zadáno ID bloku a stejné ID bloku existuje v seznamu potvrzených i nepotvrzených bloků, Put Block List potvrdí blok ze seznamu nepotvrzených bloků. Pokud ID bloku existuje v seznamu potvrzených blokovaných, ale ne v seznamu nepotvrzených bloků, Put Block List potvrdí blok ze seznamu potvrzených bloků.

Každý blok v objektu blob bloku může mít jinou velikost. Objekt blob bloku může obsahovat maximálně 50 000 potvrzených bloků. Maximální počet nepotvrzených bloků, které mohou být přidružené k objektu blob, je 100 000.

Následující tabulka popisuje maximální povolené velikosti bloků a objektů blob podle verze služby:

Verze služby Maximální velikost bloku (přes Put Block) Maximální velikost objektu blob (přes Put Block List) Maximální velikost objektu blob prostřednictvím jedné operace zápisu (přes Put Blob)
Verze 2019-12-12 a novější 4 000 mebibajtů (MiB) Přibližně 190,7 tebibajtů (TiB) (4 000 MiB × 50 000 bloků) 5 000 MiB
Verze 2016-05-31 až 2019-07-07-07 100 MiB Přibližně 4,75 TiB (100 MiB × 50 000 bloků) 256 MiB
Verze starší než 31. 5. 2016 4 MiB Přibližně 195 GiB (4 MiB × 50 000 bloků) 64 MiB

Při volání Put Block List za účelem aktualizace existujícího objektu blob se přepíšou existující vlastnosti objektu blob a metadata. Všechny existující snímky se ale s objektem blob zachovají. Hlavičky podmíněného požadavku můžete použít k provedení operace pouze v případě, že je splněna zadaná podmínka.

Put Block List Pokud operace selže kvůli chybějícímu bloku, musíte chybějící blok nahrát.

Všechny nepotvrzené bloky se v případě, že během týdne od poslední úspěšné Put Block operace nedojde k Put Block žádným úspěšným voláním objektu blob nebo Put Block List do objektu blob. Pokud se v objektu blob volá příkaz Put Blob , všechny nepotvrzené bloky se vygenerují z paměti.

Pokud jsou značky zadané v x-ms-tags hlavičce, musí být zakódované řetězcem dotazu. Klíče a hodnoty značek musí splňovat požadavky na pojmenování a délku, jak je uvedeno v Set Blob Tags. Hlavička x-ms-tags může dále obsahovat značky o velikosti až 2 KiB. Pokud je potřeba více značek, použijte operaci Nastavit značky objektů blob .

Pokud má objekt blob aktivní zapůjčení, musí klient zadat platné ID zapůjčení v žádosti o potvrzení seznamu blokovaných. Pokud klient nezadá ID zapůjčení nebo zadá neplatné ID zapůjčení, vrátí Blob Storage stavový kód 412 (Předběžná podmínka se nezdařila). Pokud klient zadá ID zapůjčení, ale objekt blob nemá aktivní zapůjčení, vrátí blob Storage také stavový kód 412 (Předběžná podmínka se nezdařila). Pokud klient zadá ID zapůjčení objektu blob, který ještě neexistuje, vrátí služba Blob Storage stavový kód 412 (Předběžná podmínka selhala) pro požadavky provedené proti verzi 2013-08-15 nebo novější. Ve starších verzích vrátí Blob Storage stavový kód 201 (Vytvořeno).

Pokud má objekt blob aktivní zapůjčení a zavoláte Put Block List k aktualizaci objektu blob, zapůjčení se udržuje v aktualizovaném objektu blob.

Put Block List platí jenom pro objekty blob bloku. Výsledkem volání Put Block List na objektu blob stránky je stavový kód 400 (chybný požadavek).

Přepsání archivovaného objektu blob selže a přepsání objektu hot blob nebo cool zdědí vrstvu ze starého objektu blob, pokud není k dispozici hlavička x-ms-access-tier.

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 Put Block List žádosti založené na typu účtu úložiště:

Operace Typ účtu úložiště Kategorie fakturace
Put Block List Objekt blob bloku úrovně Premium
Standard pro obecné účely v2
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é

Principy objektů blob bloku, doplňovacích objektů blob a objektů blob stránky
Autorizace žádostí do Služby Azure Storage
Stavové kódy a kódy chyb
Kódy chyb služby Blob Service
Nastavení časových limitů pro operace služby Blob Service