Vložení objektu blob

Článek
05/15/2024

Operace Put Blob vytvoří nový blok, stránku nebo doplňovací objekt blob nebo aktualizuje obsah existujícího objektu blob bloku. Operace Put Blob přepíše veškerý obsah existujícího objektu blob se stejným názvem.

Při aktualizaci existujícího objektu blob bloku přepíšete všechna existující metadata objektu blob. Obsah existujícího objektu blob se přepíše obsahem nového objektu blob. Částečné aktualizace nejsou podporovány v nástroji Put Blob. Pokud chcete provést částečnou aktualizaci obsahu objektu blob bloku, použijte operaci Vložit seznam bloků .

Doplňovací objekt blob můžete vytvořit jenom ve verzích 2015-02-21 a novějších.

Volání objektu Put Blob pro vytvoření objektu blob stránky nebo doplňovací objekt blob pouze inicializuje objekt blob. Pokud objekt blob už existuje, obsah se vymaže. Pokud chcete přidat obsah do objektu blob stránky, zavolejte operaci Vložit stránku . Pokud chcete přidat obsah do doplňovacího objektu blob, zavolejte operaci Připojit blok .

Žádost

Požadavek můžete vytvořit Put Blob 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`	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`	HTTP/1.1

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 je možné zadat následující další parametry:

Parametr	Popis
`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 Service.

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

Požadované a volitelné hlavičky požadavků pro všechny typy objektů blob 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 požadavku. Pro objekt blob stránky nebo doplňovací objekt blob musí být hodnota této hlavičky nastavená na nulu, protože put blob se používá pouze k inicializaci objektu blob. Pokud chcete zapsat obsah do existujícího objektu blob stránky, zavolejte Vložit stránku. Pokud chcete zapisovat obsah do doplňovacího objektu blob, zavolejte přidávací blok.
`Content-Type`	Nepovinný parametr. Typ obsahu MIME objektu blob. Výchozí typ je `application/octet-stream`.
`Content-Encoding`	Nepovinný parametr. Určuje, která kódování obsahu se na objekt blob použila. Tato hodnota se klientovi vrátí, když se na prostředku objektu blob provede operace Získání objektu blob. Po vrácení této hodnoty ji klient může použít k dekódování obsahu objektu blob.
`Content-Language`	Nepovinný parametr. Určuje přirozené jazyky používané tímto prostředkem.
`Content-MD5`	Nepovinný parametr. Hodnota hash MD5 obsahu objektu blob. Tato hodnota hash se používá k ověření integrity objektu blob během přenosu. Když je tato hlavička zadána, služba úložiště zkontroluje hodnotu hash, která přišla, proti hodnotě, která byla odeslána. Pokud se tyto dvě hodnoty hash neshodnou, operace selže s kódem chyby 400 (Chybný požadavek). Pokud je hlavička vynechána ve verzi 2012-02-12 nebo novější, blob Storage vygeneruje hodnotu hash MD5. Výsledky z možností Získat objekt blob, Získat vlastnosti objektu blob a Výpis objektů blob obsahují hodnotu hash MD5.
`x-ms-content-crc64`	Nepovinný parametr. Hodnota hash CRC64 obsahu objektu blob. Tato hodnota hash se používá k ověření integrity objektu blob během přenosu. Když je tato hlavička zadána, služba úložiště zkontroluje hodnotu hash, která přišla, proti hodnotě, která byla odeslána. Pokud se tyto dvě hodnoty hash neshodnou, operace selže s kódem chyby 400 (Chybný požadavek). Tato hlavička je podporovaná ve verzích 02-02-2019 a novějších. Pokud jsou k dispozici hlavičky Content-MD5 i x-ms-content-crc64, požadavek selže s chybou 400 (chybný požadavek).
`Cache-Control`	Nepovinný parametr. Blob Storage tuto hodnotu ukládá, ale nepoužívá ji ani neupravuje.
`x-ms-blob-content-type`	Nepovinný parametr. Nastavte typ obsahu objektu blob.
`x-ms-blob-content-encoding`	Nepovinný parametr. Nastavte kódování obsahu objektu blob.
`x-ms-blob-content-language`	Nepovinný parametr. Nastavte jazyk obsahu objektu blob.
`x-ms-blob-content-md5`	Nepovinný parametr. Nastavte hodnotu hash MD5 objektu blob. Pro BlockBlob má tato hlavička přednost před `Content-MD5` ověřováním integrity objektu blob během přenosu. Pro PageBlob a AppendBlob tato hlavička přímo nastaví hodnotu hash MD5 objektu blob.
`x-ms-blob-cache-control`	Nepovinný parametr. Nastaví ovládací prvek mezipaměti objektu blob.
`x-ms-blob-type: <BlockBlob ¦ PageBlob ¦ AppendBlob>`	Povinná hodnota. Určuje typ objektu blob, který se má vytvořit: objekt blob bloku, objekt blob stránky nebo doplňovací objekt blob. Podpora vytváření doplňovacích objektů blob je k dispozici pouze ve verzi 2015-02-21 a novější.
`x-ms-meta-name:value`	Nepovinný parametr. Páry název-hodnota přidružené k objektu blob jako metadata. Poznámka: Od verze 2009-09-19 musí názvy metadat splňovat pravidla pojmenování identifikátorů jazyka C#.
`x-ms-encryption-scope`	Nepovinný parametr. Označuje rozsah šifrování, který se má použít k šifrování obsahu požadavku. Tato hlavička je podporovaná ve verzích 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í dané značky zakódované v řetězci dotazu v objektu blob. 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-blob-content-disposition`	Nepovinný parametr. Nastaví hlavičku objektu `Content-Disposition` blob. K dispozici pro verze 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 můžete ho použít k připojení dalších metadat. Pokud je například hlavička nastavená na `attachment`hodnotu , znamená to, že by uživatelský agent neměl zobrazovat odpověď. Místo toho by se mělo zobrazit dialogové okno Uložit jako s jiným názvem souboru než zadaným názvem 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 hlavičky sdílení prostředků mezi zdroji (CORS) v odpovědi. Další informace najdete v tématu Podpora CORS pro služby Azure Storage.
`x-ms-client-request-id`	Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který se zaznamená do protokolů analýzy 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 Informace o protokolování Analýzy úložiště.
`x-ms-access-tier`	Nepovinný parametr. Úroveň, která se má nastavit v objektu blob. Pro objekty blob stránky ve Premium Storage účet pouze s verzí 2017-04-17 a novější. Úplný seznam podporovaných úrovní objektů blob stránky najdete v tématu Vysoce výkonné úložiště Premium a spravované disky pro virtuální počítače. Pro objekty blob bloku se podporují ve službě Blob Storage nebo účtech pro obecné účely verze 2018-11-09 a novější. Platné hodnoty pro úrovně objektů blob bloku jsou `Hot`, `Cool`, `Cold`a `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`. V `unlocked`nástroji můžou uživatelé změnit zásady zvýšením nebo snížením data uchovávání. V `locked`nástroji jsou tyto akce 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. Další informace najdete v tématu 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ů.

Tato operace také podporuje použití podmíněných hlaviček k zápisu 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)

Hlavičky požadavků, které se dají použít jenom pro operace s objekty blob stránky, jsou popsané v následující tabulce:

Hlavička požadavku	Popis
`x-ms-blob-content-length: bytes`	Vyžaduje se pro objekty blob stránky. Tato hlavička určuje maximální velikost objektu blob stránky, a to až 8 tebibajtů (TiB). Velikost objektu blob stránky musí být zarovnaná na hranici 512 bajtů. Pokud je tato hlavička určená pro objekt blob bloku nebo doplňovací objekt blob, služba Blob Storage vrátí stavový kód 400 (Chybný požadavek).
`x-ms-blob-sequence-number: <num>`	Nepovinný parametr. Nastavte pouze objekty blob stránky. Pořadové číslo je uživatelsky řízená hodnota, kterou můžete použít ke sledování požadavků. Hodnota pořadového čísla musí být od 0 do 2^{^63} - 1. Výchozí hodnota je 0.
`x-ms-access-tier`	Verze 2017-04-17 a novější. Pouze pro objekty blob stránky v účtu úložiště úrovně Premium. Určuje úroveň, která se má nastavit v objektu blob. Úplný seznam podporovaných úrovní najdete v tématu Vysoce výkonné úložiště Premium a spravované disky pro virtuální počítače.
`x-ms-client-request-id`	Tato hlavička se dá 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 se nachází v požadavku, a hodnota obsahuje maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička `x-ms-client-request-id` v požadavku nenachází, v odpovědi se nezobrazí.

Hlavičky požadavku (šifrovací klíče poskytnuté zákazníkem)

Od verze 2019-02-02 je možné 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 případě objektu blob bloku obsahuje text požadavku obsah objektu blob.

V případě objektu blob stránky nebo doplňovacích objektů blob je text požadavku prázdný.

Ukázkový požadavek

Následující příklad ukazuje požadavek na vytvoření objektu blob bloku:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-content-disposition: attachment; filename="fname.ext"  
x-ms-blob-type: BlockBlob  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 11  
  
Request Body:  
hello world

Tento ukázkový požadavek vytvoří objekt blob stránky a určí jeho maximální velikost jako 1 024 bajtů. Pokud chcete přidat obsah do objektu blob stránky, musíte volat Put Page:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/mypageblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: PageBlob  
x-ms-blob-content-length: 1024  
x-ms-blob-sequence-number: 0  
Authorization: SharedKey   
Origin: http://contoso.com  
Vary: Origin  
myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0

Tento ukázkový požadavek vytvoří doplňovací objekt blob. Pokud chcete přidat obsah do doplňovacího objektu blob, musíte zavolat přidávací blok:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myappendblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: AppendBlob  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Origin: http://contoso.com  
Vary: Origin  
Content-Length: 0

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.

Hlavička odpovědi	Description
`ETag`	Obsahuje hodnotu, kterou může klient použít k provádění podmíněných `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. Všechny operace zápisu do objektu blob (včetně aktualizací metadat nebo vlastností objektu blob) změní čas poslední změny objektu blob.
`Content-MD5`	Vráceno pro objekt blob bloku, aby klient mohl zkontrolovat integritu obsahu zprávy. Vrácená `Content-MD5` hodnota se vypočítá službou Blob Storage. Ve verzi 2012-02-12 a novějších se tato hlavička vrátí, i když požadavek neobsahuje `Content-MD5` hlavičky nebo `x-ms-blob-content-md5` .
`x-ms-content-crc64`	Vráceno pro objekt blob bloku, aby klient mohl zkontrolovat integritu obsahu zprávy. Vrácená `x-ms-content-crc64` hodnota se vypočítá službou Blob Storage. Tato hlavička se vždy vrátí od verze 2019-02-02.2019.
`x-ms-request-id`	Jednoznač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`	Označuje verzi služby Blob Storage, která se použila ke spuštění požadavku. Vráceno pro žádosti provedené proti 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. Tato hlavička vrátí hodnotu hlavičky žádosti původu, pokud existuje shoda.
`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é nepovoluje všechny zdroje. Tato hlavička je nastavená na hodnotu true.
`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 `false`hodnota .
`x-ms-encryption-key-sha256`	Verze 2019-02-02 a novější. Vráceno, 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í poskytnutého klíče.
`x-ms-encryption-scope`	Verze 2019-02-02 a novější. Vráceno, pokud požadavek používal obor šifrování, aby klient mohl zajistit úspěšné šifrování obsahu požadavku pomocí oboru šifrování.
`x-ms-version-id: <DateTime>`	Verze 2019-12-12 a novější. Tato hlavička 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.

Text odpovědi

Žádné

Ukázková odpověď

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==  
x-ms-content-crc64: 77uWZTolTHU
Date: <date>  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: <date>  
Access-Control-Allow-Origin: http://contoso.com  
Access-Control-Expose-Headers: Content-MD5  
Access-Control-Allow-Credentials: True  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>

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 Put Blob , 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 autorizační požadavky operace Nastavit značky objektů blob .

Důležité

Microsoft doporučuje používat Microsoft Entra ID se spravovanými identitami k autorizaci požadavků do služby Azure Storage. Microsoft Entra ID poskytuje v porovnání s autorizací pomocí sdíleného klíče vynikající zabezpečení a snadné použití.

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í ověří 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 nezbytné k volání Put Blob operace Microsoft Entra uživatelem, skupinou, spravovanou identitou nebo instančním objektem a předdefinovanou rolí Azure RBAC s nejnižšími oprávněními, která zahrnuje tuto akci:

Akce Azure RBAC:
- Create nového objektu blob bloku: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
- Create nový nebo přepsat existující objekt blob bloku: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Předdefinovaná role s nejnižšími oprávněními:Přispěvatel dat v objektech blob služby Storage

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.

Sdílený přístupový podpis (SAS) poskytuje zabezpečený delegovaný přístup k prostředkům v účtu úložiště. V případě sdíleného přístupového podpisu máte podrobnou kontrolu nad tím, jak může klient přistupovat k datům. Můžete určit, k jakému prostředku může klient přistupovat, jaká oprávnění k těmto prostředkům má a jak dlouho je sas platný.

Operace Put Blob podporuje tři typy sdílených přístupových podpisů: SAS delegování uživatele, SAS služby a SAS účtu.

Jako osvědčený postup zabezpečení doporučujeme používat přihlašovací údaje Microsoft Entra místo klíče účtu úložiště, který může být snadněji ohrožen. Pokud návrh aplikace vyžaduje sdílené přístupové podpisy, pokud je to možné, použijte k vytvoření SAS delegování uživatele Microsoft Entra přihlašovací údaje.

Pokud je pro účet úložiště zakázaný přístup ke sdílenému klíči, token SAS služby nebo token SAS účtu nebudou v požadavku na službu Blob Storage povoleny. Další informace najdete v tématu Vysvětlení, jak zakázání sdíleného klíče ovlivňuje tokeny SAS.

SAS delegování uživatele

SAS delegování uživatele je zabezpečeno Microsoft Entra přihlašovacími údaji a také oprávněními zadanými pro SAS.

Put Blob Volání operace pomocí tokenu SAS delegovaného na prostředek kontejneru nebo objektu blob vyžaduje v rámci tokenu SAS delegování uživatele následující oprávnění:

Operace	Podepsané oprávnění
Vložení objektu blob (vytvoření nového objektu blob bloku)	Create (c) nebo Zápis (w)
Vložení objektu blob (přepsání existujícího objektu blob bloku)	Zápis (w)

Další informace o SAS delegování uživatele najdete v tématu Create SAS delegování uživatele.

Sas služby

Sdílený přístupový podpis služby je zabezpečený pomocí klíče účtu úložiště. SAS služby deleguje přístup k prostředku v jedné službě Azure Storage, jako je úložiště objektů blob.

Put Blob Volání operace pomocí tokenu SAS delegovaného na prostředek kontejneru nebo objektu blob vyžaduje následující oprávnění jako součást tokenu SAS služby.

Operace	Podepsané oprávnění
Vložení objektu blob (vytvoření nového objektu blob bloku)	Create (c) nebo Zápis (w)
Vložení objektu blob (přepsání existujícího objektu blob bloku)	Zápis (w)

Další informace o SAS služby najdete v tématu Create SAS služby.

Sas účtu

SAS účtu je zabezpečené pomocí klíče účtu úložiště. SAS účtu deleguje přístup k prostředkům v jedné nebo více službách úložiště. Všechny operace dostupné prostřednictvím sas pro službu nebo delegování uživatele jsou dostupné také prostřednictvím SAS účtu.

Následující tabulka uvádí typ podepsaného prostředku a podepsaná oprávnění, která se mají zadat při delegování přístupu:

Operace	Podepsaná služba	Typ podepsaného prostředku	Podepsané oprávnění
Vložení objektu blob (vytvoření nového objektu blob bloku)	Objekt blob (b)	Objekt (o)	Create (c) nebo Zápis (w)
Vložení objektu blob (přepsání existujícího objektu blob bloku)	Objekt blob (b)	Objekt (o)	Zápis (w)

Další informace o SAS účtu najdete v tématu Create SAS účtu.

Poznámky

Při vytváření objektu blob musíte zadat, jestli se jedná o objekt blob bloku, doplňovací objekt blob nebo objekt blob stránky, a to zadáním hodnoty hlavičky x-ms-blob-type . Po vytvoření objektu blob se typ objektu blob nedá změnit, dokud se neodstraní a znovu nevytvořil.

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

Pokud se pokusíte nahrát objekt blob bloku, který je větší než maximální povolená velikost pro danou verzi služby, nebo objekt blob stránky větší než 8 TiB, vrátí služba stavový kód 413 (příliš velká entita požadavku). Blob Storage také vrací další informace o chybě v odpovědi, včetně maximální povolené velikosti objektu blob, v bajtech.

Pokud chcete vytvořit nový objekt blob stránky, nejprve objekt blob inicializujete voláním Put Bloba pak zadejte jeho maximální velikost, až 8 TiB. Při vytváření objektu blob stránky nezahrnujte obsah do textu požadavku. Po vytvoření objektu blob volejte Vložit stránku a přidejte do objektu blob obsah nebo ho upravte.

Pokud chcete vytvořit nový doplňovací objekt blob, zavolejte Put Blob a vytvořte ho s délkou obsahu 0 bajtů. Po vytvoření doplňovacího objektu blob zavolejte přidávací blok a přidejte na jeho konec obsah.

Pokud zavoláte Put Blob k přepsání existujícího objektu blob se stejným názvem, všechny snímky přidružené k původnímu objektu blob se zachovají. Pokud chcete odebrat přidružené snímky, nejprve zavolejte příkaz Odstranit objekt blob a pak zavolejte Put Blob , abyste objekt blob vytvořili znovu.

Vlastní vlastnosti objektu blob

Objekt blob má vlastní vlastnosti (nastavené prostřednictvím hlaviček), které můžete použít k ukládání hodnot přidružených ke standardním hlavičkám HTTP. Tyto hodnoty můžete následně přečíst voláním funkce Get Blob Properties (Získat vlastnosti objektu blob) nebo je upravit voláním set blob properties (Nastavit vlastnosti objektu blob). Hlavičky vlastních vlastností a odpovídající standardní hlavičky HTTP jsou uvedeny v následující tabulce:

Hlavička HTTP	Hlavička vlastní vlastnosti objektu blob
`Content-Type`	`x-ms-blob-content-type`
`Content-Encoding`	`x-ms-blob-content-encoding`
`Content-Language`	`x-ms-blob-content-language`
`Content-MD5`	`x-ms-blob-content-md5`
`Cache-Control`	`x-ms-blob-cache-control`

Sémantika pro nastavení nebo zachování těchto hodnot vlastností s objektem blob je následující:

Pokud klient zadá hlavičku vlastní vlastnosti, jak je uvedeno v předponě x-ms-blob , uloží se tato hodnota s objektem blob.
Pokud klient určí standardní hlavičku HTTP, ale ne hlavičku vlastní vlastnosti, hodnota se uloží v odpovídající vlastní vlastnosti, která je přidružená k objektu blob, a vrátí se voláním Get Blob Properties. Pokud například klient nastaví hlavičku Content-Type požadavku, uloží se tato hodnota ve vlastnosti objektu blob x-ms-blob-content-type .
Pokud klient nastaví standardní hlavičku HTTP i odpovídající hlavičku vlastnosti na stejném požadavku, použije požadavek PUT hodnotu, která je zadána pro standardní hlavičku HTTP, ale hodnota zadaná pro hlavičku vlastní vlastnosti se zachová s objektem blob a vrátí se následnými požadavky GET.

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. Kromě toho může hlavička x-ms-tags obsahovat až 2 kB značek. 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 přepsání objektu blob. 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 a novější. Pro verze starší než 15. 8. 2013 vrátí Blob Storage stavový kód 201 (Vytvořeno).

Pokud operace přepíše existující objekt blob s aktivním zapůjčením Put Blob , zapůjčení zůstane v aktualizovaném objektu blob, dokud nevyprší jeho platnost nebo se nevydá.

Dokončení Put Blob operace je povoleno 10 minut na MiB. Pokud operace trvá v průměru déle než 10 minut na MiB, vyprší časový limit operace.

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

ExpiryOption

Následující hodnoty můžete odeslat jako x-ms-expiry-option záhlaví. V této hlavičce se nerozlišuje velká a malá písmena.

Možnost vypršení platnosti	Description
`RelativeToNow`	Nastaví datum vypršení platnosti vzhledem k aktuálnímu času. `x-ms-expiry-time` musí být zadán jako počet milisekund, který má uplynout od současného času.
`Absolute`	`x-ms-expiry-time` musí být zadán jako absolutní čas ve formátu RFC 1123.
`NeverExpire`	Nastaví nikdy nevyprší platnost objektu blob nebo odebere aktuální datum vypršení platnosti. `x-ms-expiry-time` nesmí být zadán.

Sémantika pro nastavení data vypršení platnosti objektu blob je následující:

Set Expiry lze nastavit pouze pro objekt blob, nikoli adresář.
Set Expiry s objektem expiryTime v minulosti není povoleno.
ExpiryTime nelze zadat s expiryOption hodnotou Never.

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

Operace	Typ účtu úložiště	Kategorie fakturace
Vložení objektu blob	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é

Autorizace požadavků 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

Sdílet prostřednictvím