Vložení objektu blob z adresy URL

  • Článek

Operace Put Blob From URL vytvoří nový objekt blob bloku, ve kterém se obsah objektu blob načte ze zadané adresy URL. Toto rozhraní API je k dispozici od verze 2020-04-08.

Částečné aktualizace nejsou podporovány v nástroji Put Blob From URL. Obsah existujícího objektu blob se přepíše obsahem nového objektu blob. Pokud chcete provést částečné aktualizace obsahu objektu blob bloku pomocí zdrojové adresy URL, použijte rozhraní API Put Blob From URL ve spojení s Put Block List.

Velikost zdrojového objektu blob může být maximálně 5 000 mebibajtů (MiB).

Žádost

Můžete vytvořit následujícím Put Blob From URL 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 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 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 je možné 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. Určuje počet bajtů přenášených v textu požadavku. Hodnota této hlavičky musí být nastavena na 0. Pokud délka není 0, operace selže se stavovým kódem 400 (Chybný požadavek).
x-ms-copy-source:name Povinná hodnota. Určuje adresu URL zdrojového objektu blob. Hodnotou může být adresa URL o délce až 2 kibibajtů (KiB), která určuje objekt blob. Hodnota by měla být zakódovaná jako adresa URL, jak by se zobrazovala v identifikátoru URI požadavku. Zdrojový objekt blob musí být veřejný nebo musí být autorizovaný prostřednictvím sdíleného přístupového podpisu. Pokud je zdrojový objekt blob veřejný, nevyžaduje se k provedení operace žádná autorizace. Pokud je velikost zdrojového objektu blob větší než 5 000 MiB nebo pokud zdroj nevrací platnou Content-Length hodnotu, požadavek selže se stavovým kódem 409 (Konflikt). Tady je několik příkladů adres URL zdrojových objektů:

- https://myaccount.blob.core.windows.net/mycontainer/myblob
- https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>
- https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>
x-ms-copy-source-authorization: <scheme> <signature> Nepovinný parametr. Určuje schéma autorizace a podpis pro zdroj kopírování. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Azure Active Directory podporuje pouze nosné schéma.
Tato hlavička je podporovaná ve verzi 2020-10-02 a novějších.
x-ms-blob-type: BlockBlob Povinná hodnota. Určuje typ objektu blob, který se má vytvořit, který musí být BlockBlob. Pokud typ objektu blob není BlockBlob, operace selže se stavovým kódem 400 (Chybný požadavek).
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 u objektu blob použila. Tato hodnota se klientovi vrátí při provedení operace Získání objektu blob s prostředkem objektu blob. Když se vrátí tato hodnota, klient ji 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.
Cache-Control Nepovinný parametr. Blob Storage tuto hodnotu ukládá, ale nepoužívá ji ani neupravuje.
x-ms-source-content-md5 Nepovinný parametr. Hodnota hash MD5 obsahu objektu blob z identifikátoru URI. Tato hodnota hash se používá k ověření integrity objektu blob během přenosu dat z identifikátoru URI. Když je tato hlavička zadána, služba úložiště porovná hodnotu hash obsahu, který byl doručen ze zdroje kopírování, s touto hodnotou hlavičky. Pokud je tato hlavička vynechána, blob Storage vygeneruje hodnotu hash MD5.

Pokud se tyto dvě hodnoty hash neshodí, operace selže s kódem chyby 400 (Chybný požadavek).
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ž zadáte tuto hlavičku, služba úložiště zkontroluje příchozí hodnotu hash proti hodnotě, která byla odeslána. Pokud se tyto dvě hodnoty hash neshodí, operace selže s kódem chyby 400 (Chybný požadavek). Tato hlavička je podporovaná ve verzi 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).
x-ms-blob-content-type Nepovinný parametr. Nastaví typ obsahu objektu blob.
x-ms-blob-content-encoding Nepovinný parametr. Nastaví kódování obsahu objektu blob.
x-ms-blob-content-language Nepovinný parametr. Nastaví jazyk obsahu objektu blob.
x-ms-blob-content-md5 Nepovinný parametr. Nastaví hodnotu hash MD5 objektu blob.
x-ms-blob-cache-control Nepovinný parametr. Nastaví ovládací prvek mezipaměti objektu blob.
x-ms-meta-name:value Nepovinný parametr. Páry název-hodnota, které jsou přidružené k objektu blob jako metadata.

Poznámka: Od verze 2009-09-19 musí názvy metadat splňovat pravidla pojmenování pro identifikátory jazyka C#.
x-ms-encryption-scope Nepovinný parametr. Obor šifrování, který se má použít k zašifrování obsahu požadavku. Tato hlavička je podporovaná ve verzi 2019-02-02 a novějších.
x-ms-tags Nepovinný parametr. Nastaví v objektu blob zadané 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-copy-source-tag-option Nepovinný parametr. Možné hodnoty jsou REPLACE nebo COPY (rozlišují se malá a velká písmena). Výchozí hodnota je NAHRADIT.

Pokud je zadaný parametr COPY, zkopírují se značky ze zdrojového objektu blob do cílového objektu blob. Zdrojový objekt blob musí být soukromý a požadavek musí mít oprávnění k získání značek objektů blob pro zdrojový objekt blob a nastavení značek objektů blob v cílovém objektu blob. Tím dojde ke dodatečnému volání operace Získání značek objektů blob ve zdrojovém účtu.

REPLACE nastaví značky, které jsou určené hlavičkou x-ms-tags cílového objektu blob. Pokud se použije funkce NAHRADIT a v objektu x-ms-tagsnejsou zadané žádné značky, na cílovém objektu blob se nenastaví žádné značky. Zadání příkazu COPY a x-ms-tags výsledkem je 409 (Konflikt).

Podporováno ve verzi 2021-04-10 a novější.
x-ms-copy-source-blob-properties Nepovinný parametr. Určuje chování vlastností objektu blob zdroje kopírování. Pokud je nastavená hodnota True, vlastnosti zdrojového objektu blob se zkopírují do nového objektu blob. Výchozí hodnota je True.
x-ms-source-if-modified-since Nepovinný parametr. Hodnota DateTime . Tuto podmíněnou hlavičku zadejte, pokud chcete objekt blob umístit pouze v případě, že zdrojový objekt blob byl od zadaného data a času změněn. Pokud nedošlo k úpravě zdrojového objektu blob, vrátí Blob Storage stavový kód 412 (Předběžná podmínka se nezdařila). Tuto hlavičku nelze zadat, pokud je zdrojem sdílená složka Azure Files.
x-ms-source-if-unmodified-since Nepovinný parametr. Hodnota DateTime . Tuto podmíněnou hlavičku zadejte, pokud chcete objekt blob umístit pouze v případě, že zdrojový objekt blob nebyl od zadaného data a času změněn. Pokud došlo ke změně zdrojového objektu blob, vrátí služba Blob Storage stavový kód 412 (Předběžná podmínka se nezdařila). Tuto hlavičku nelze zadat, pokud je zdrojem sdílená složka Azure Files.
x-ms-source-if-match Nepovinný parametr. Hodnota ETag. Tuto podmíněnou hlavičku zadejte, pokud chcete zdrojový objekt blob umístit jenom v případě, že jeho značka ETag odpovídá zadané hodnotě. Pokud se hodnoty ETag neshoduje, vrátí Blob Storage stavový kód 412 (Předběžná podmínka selhala). Tuto hlavičku nelze zadat, pokud je zdrojem sdílená složka Azure Files.
x-ms-source-if-none-match Nepovinný parametr. Hodnota ETag. Tuto podmíněnou hlavičku zadejte tak, aby se objekt blob umístil jenom v případě, že jeho značka ETag neodpovídá zadané hodnotě. Pokud jsou hodnoty identické, blob Storage vrátí stavový kód 412 (Předběžná podmínka se nezdařila). Tuto hlavičku nelze zadat, pokud je zdrojem sdílená složka Azure Files.
If-Modified-Since Nepovinný parametr. Hodnota DateTime . Tuto podmíněnou hlavičku zadejte, pokud chcete objekt blob umístit pouze v případě, že se cílový objekt blob od zadaného data a času změnil. Pokud se cílový objekt blob nezměnil, vrátí Blob Storage stavový kód 412 (Předběžná podmínka se nezdařila).
If-Unmodified-Since Nepovinný parametr. Hodnota DateTime . Tuto podmíněnou hlavičku zadejte tak, aby se objekt blob umístil jenom v případě, že se cílový objekt blob od zadaného data a času nezměnil. Pokud došlo k úpravě cílového objektu blob, vrátí služba Blob Storage stavový kód 412 (Předběžná podmínka se nezdařila).
If-Match Nepovinný parametr. Hodnota ETag. Zadejte hodnotu ETag pro tuto podmíněnou hlavičku, aby se objekt blob umístil pouze v případě, že zadaná hodnota značky ETag odpovídá hodnotě ETag existujícího cílového objektu blob. Pokud značka ETag cílového objektu blob neodpovídá značkě ETag zadané pro If-Match, blob Storage vrátí stavový kód 412 (Předběžná podmínka se nezdařila).
If-None-Match Nepovinný parametr. Hodnota ETag nebo zástupný znak (*).

Zadejte hodnotu ETag pro tuto podmíněnou hlavičku, aby se objekt blob umístil pouze v případě, že zadaná hodnota značky ETag neodpovídá hodnotě ETag cílového objektu blob.

Zadejte zástupný znak (*), který provede operaci pouze v případě, že cílový objekt blob neexistuje.

Pokud zadaná podmínka není splněná, vrátí Blob Storage stavový kód 412 (Předběžná podmínka se nezdařila).
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 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 hlavička nastavená na attachmenthodnotu , 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, když je protokolování analýzy úložiště povolené. 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-access-tier Nepovinný parametr. Označuje úroveň, která se má nastavit v objektu blob. 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ší. Hot, Coola Archive se podporují ve verzi 2018-11-09 a novější. Další informace o vrstvení objektů blob bloku najdete v tématu Horká, studená a archivní vrstva úložiště.
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 určitá 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)

V požadavku na šifrování objektu blob pomocí klíče poskytnutého zákazníkem je možné 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

Žádné

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: 2020-04-08  
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-copy-source: https://myaccount.blob.core.windows.net/mycontainer/myblob
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
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 Značka 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. 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. Tato hlavička se 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 vrátí vždy.
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 Verze služby Blob Storage, která se použila ke spuštění požadavku.
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 true.
x-ms-request-server-encrypted: true/false 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 nastavená na false.
x-ms-encryption-key-sha256 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 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> Vrátí neprůselnou DateTime hodnotu, která jednoznačně identifikuje objekt blob. Hodnota této hlavičky označuje verzi objektu blob a může 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 From URL , 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 .

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 From URL operace Microsoft Entra uživatele, skupiny nebo instančního objektu a předdefinované role Azure RBAC s nejnižšími oprávněními, která tuto akci zahrnuje:

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 Blob From URL se podporuje od verze 2020-04-08.

Ve verzi 2020-10-02 a novější se pro zdroj operace kopírování podporuje autorizace Azure Active Directory.

Zdrojový objekt blob může být libovolného typu, včetně objektu blob bloku, doplňovacího objektu blob nebo objektu blob stránky. Cílovým objektem blob ale musí být objekt blob bloku.

Operace Put Blob From URL vždy zkopíruje celý zdrojový objekt blob. Kopírování rozsahu bajtů nebo sady bloků se nepodporuje. Pokud chcete provést částečné aktualizace, podívejte se na adresu URL pro vložení bloku. Cílovým objektem blob může být existující objekt blob bloku nebo nový objekt blob vytvořený operací.

Když jako zdrojový objekt používáte objekt blob bloku, zkopíruje se veškerý potvrzený obsah objektu blob. Seznam blokovaných bloků se ale nezachová a nepotvrzené bloky se nekopírují. Obsah cílového objektu blob je shodný s obsahem zdrojového objektu blob, ale seznam potvrzených bloků se nezachová.

Vložení vlastností a metadat objektů blob

Při vytváření objektu blob bloku ze zdroje kopírování se standardní vlastnosti objektu blob ve výchozím nastavení zkopírují ze zdrojového objektu blob. Pokud jsou metadata aplikace zadaná v požadavku, uloží se bez kopírování metadat zdrojového objektu blob. Pokud chcete explicitně nastavit jakékoli hlavičky obsahu HTTP, můžete v požadavku zadat odpovídající hlavičku.

  • Content-Type

  • Content-Encoding

  • Content-Length

  • Cache-Control

  • Content-Disposition

Velikost cílového objektu blob se vždy shoduje s velikostí zdrojového objektu blob. Hlavička Content-Length musí mít v Put Blob From URL požadavku hodnotu 0 (protože neexistuje text požadavku) a vlastnost délka obsahu cílového objektu blob se odvodí z velikosti zdroje.

Vložení objektu blob z vlastních vlastností adresy URL

Put Blob From Url používá stejnou sémantiku jako Put Blob pro nastavení vlastních vlastností přidružených ke standardním hlavičkám HTTP. Další informace najdete v tématu Vlastní vlastnosti objektu blob.

Značky indexu objektů blob

Pokud jsou v x-ms-tags hlavičce uvedené značky pro cílový objekt blob, 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 navíc obsahovat až 2 KiB značek. Pokud se vyžaduje více značek, použijte operaci Set Blob Tags .

Pokud v hlavičce nejsou značky, x-ms-tags nezkopírují se ze zdrojového objektu blob.

Rozsahy šifrování a klíče poskytnuté zákazníkem

Rozhraní API Put Blob From URL podporuje obory šifrování i klíče poskytnuté zákazníkem pomocí x-ms-encryption-scope hlaviček a x-ms-encryption-key .

Pokud hlavička x-ms-copy-source odkazuje na stejný zdrojový objekt blob jako cílový objekt blob v identifikátoru URI požadavku, Put Blob From URL operace provede synchronní místní přepis objektu blob. To umožňuje přepsání objektu blob tak, aby používal jiný šifrovací klíč nebo obor šifrování.

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

Operace Typ účtu úložiště Kategorie fakturace
Vložení objektu blob z adresy URL (cílový účet1) Objekt blob bloku úrovně Premium
Standard pro obecné účely v2
Standard pro obecné účely v1		 Operace zápisu
Umístění objektu blob z adresy URL (zdrojový účet2) Objekt blob bloku úrovně Premium
Standard pro obecné účely v2
Standard pro obecné účely v1		 Operace čtení

1Cílový účet se účtuje za jednu transakci, která zahájí zápis.
2.U zdrojového účtu probíhá jedna transakce pro každou žádost o čtení zdrojového objektu.

Pokud se navíc zdrojový a cílový účet nacházejí v různých oblastech (například USA – sever a USA – jih), bude se šířka pásma použitá k přenosu požadavku účtovat zdrojovému účtu úložiště jako výchozí přenos dat. Výchozí přenos dat mezi účty ve stejné oblasti je bezplatný.

Nakonec vytvoření nového objektu blob s jiným názvem v rámci stejného účtu úložiště využívá další prostředky úložiště, takže výsledkem operace bude účtování poplatků za využití kapacity účtu úložiště pro tyto další prostředky.

Informace o cenách pro zadané kategorie fakturace najdete v tématu Azure Blob Storage Ceny.

Viz také

Autorizace požadavků na stav služby Azure Storagea kódy chybSlužby Blob Service– Nastavení časových limitů pro operace služby Blob Service