Put Block List

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

K aktualizaci objektu blob můžete volat tak Put Block List , že nahrajete jenom ty bloky, které se změnily, a pak společně potvrdíte nové a existující bloky. Můžete to udělat 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 vytvořit Put Block List následujícím způsobem. Doporučujeme použít https. Nahraďte myaccount názvem vašeho účtu úložiště:

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

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

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

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 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žadavků (š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é.

Text požadavku

V textu požadavku můžete zadat seznam bloků, který by měla služba Blob Storage zkontrolovat pro požadovaný blok. 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 nové bloky potvrdíte společně s existujícími bloky, které chcete zachovat.

Pokud chcete aktualizovat objekt blob, můžete zadat, aby služba nejprve hledala 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 použít, zadejte ID bloku, které je v příslušném elementu XML v těle požadavku, následujícím způsobem:

• Zadejte ID bloku v elementu Committed , aby bylo možné indikovat, že by služba Blob Storage měla vyhledat pouze seznam potvrzených bloků pro pojmenovaný blok. Pokud se blok v seznamu potvrzených bloků nenajde, 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 , aby bylo možné indikovat, že by služba Blob Storage měla hledat pouze seznam nepotvrzených bloků pro pojmenovaný 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 , aby bylo možné indikovat, že by služba Blob Storage měla nejprve prohledat seznam nepotvrzených bloků. Pokud se blok nachází v seznamu nepotvrzených položek, je tato verze bloku nejnovější a měla by být zapsána do objektu blob. Pokud se blok nenajde v seznamu nepotvrzených, měla by služba vyhledat pojmenovaný blok v seznamu potvrzených bloků a zapsat ho do objektu blob, pokud se najde.

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

Pokud chcete předvést Put Block List, př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 už tyto bloky byly potvrzené.

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 Put Block a zobrazí se v seznamu nepotvrzených bloků, dokud nezavoláte Put Block List.

• Aktualizovaná verze bloku s ID AZAAAA==. Tento blok musí být nejprve nahrán s voláním Put Block a zobrazí se v seznamu nepotvrzených bloků, dokud nezavoláte Put Block List.

• Odebrání bloku s ID AAAAAA== Vzhledem k tomu, že tento blok není součástí dalšího volání Put Block List, blok se v podstatě odebere 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 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.

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 .

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:

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

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