Sdílet prostřednictvím

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.

U Put Blob From URLse nepodporují částečné aktualizace. Obsah existujícího objektu blob se přepíše obsahem nového objektu blob. Pokud chcete provádět částečné aktualizace obsahu objektu blob bloku pomocí zdrojové adresy URL, použijte Put Block From URL API ve spojení s Put Block List.

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

Prosba

Put Blob From URL můžete vytvořit 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 HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob HTTP/1.1

Žádost o emulovanou službu úložiště

Při vytváření požadavku na emulovanou službu úložiště zadejte název hostitele emulátoru a port služby Blob Service jako 127.0.0.1:10000následovaný názvem emulovaného účtu úložiště:

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

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

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

Parametry identifikátoru URI

Pro identifikátor URI požadavku je možné zadat následující další parametry:

Parametr Popis
timeout Volitelný. Parametr timeout se 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

Povinná a volitelná hlavička požadavku jsou popsána v následující tabulce:

Hlavička požadavku Popis
Authorization Požadovaný. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
Date nebo x-ms-date Požadovaný. Určuje standard UTC (Coordinated Universal Time) pro požadavek. Další informace najdete v tématu Autorizace požadavků na službu 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 Požadovaný. Určuje počet bajtů přenášených v textu požadavku. Hodnota této hlavičky musí být nastavená na 0. Pokud délka není 0, operace selže se stavovým kódem 400 (Chybný požadavek).
x-ms-copy-source:name Požadovaný. Určuje adresu URL zdrojového objektu blob. Hodnota může být adresa URL 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 buď veřejný, nebo musí být autorizovaný prostřednictvím sdíleného přístupového podpisu. Pokud je zdrojový objekt blob veřejný, k provedení operace se nevyžaduje žádná autorizace. Pokud je velikost zdrojového objektu blob větší než 5000 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ého objektu:

- 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> Volitelný. Určuje autorizační schéma a podpis pro zdroj kopie. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.

Poznámka: Pro Microsoft Entra je podporováno pouze nosné schéma.

Poznámka: Pokud je zdrojový objekt veřejně přístupný nebo je váš zdrojový objekt v účtu úložiště a používáte token SAS předávaný v x-ms-copy-source:name, tato hlavička není nutná.

Tato hlavička je podporována ve verzích 2020-10-02 a novějších.
x-ms-blob-type: BlockBlob Požadovaný. 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 Volitelný. Typ obsahu MIME objektu blob. Výchozí typ je application/octet-stream.
Content-Encoding Volitelný. Určuje, které kódování obsahu se u objektu blob použilo. Tato hodnota se vrátí klientovi, když se u prostředku objektu blob provede operace Get Blob. Když se tato hodnota vrátí, klient ji může použít k dekódování obsahu objektu blob.
Content-Language Volitelný. Určuje přirozené jazyky používané tímto prostředkem.
Cache-Control Volitelný. Blob Storage ukládá tuto hodnotu, ale nepoužívá ji ani neupravuje.
x-ms-source-content-md5 Volitelný. 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. Pokud je tato hlavička zadaná, služba úložiště porovná hodnotu hash obsahu, který přišel ze zdroje kopírování, s touto hodnotou hlavičky. Pokud tuto hlavičku vynecháte, služba Blob Storage vygeneruje hodnotu hash MD5.

Pokud se dvě hodnoty hash neshoduje, operace selže s kódem chyby 400 (Chybný požadavek).
x-ms-content-crc64 Volitelný. Hodnota hash CRC64 obsahu objektu blob. Tato hodnota hash se používá k ověření integrity objektu blob během přenosu. Pokud je tato hlavička zadaná, služba úložiště zkontroluje hodnotu hash, která byla doručena proti odeslané hodnotě. Pokud se dvě hodnoty hash neshoduje, operace selže s kódem chyby 400 (Chybný požadavek). Tato hlavička je podporovaná ve verzi 2.02.2019 a novější.

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 Volitelný. Nastaví typ obsahu objektu blob.
x-ms-blob-content-encoding Volitelný. Nastaví kódování obsahu objektu blob.
x-ms-blob-content-language Volitelný. Nastaví jazyk obsahu objektu blob.
x-ms-blob-content-md5 Volitelný. Nastaví hodnotu hash MD5 objektu blob.
x-ms-blob-cache-control Volitelný. Nastaví ovládací prvek mezipaměti objektu blob.
x-ms-meta-name:value Volitelný. Dvojice name-value, které jsou přidružené k objektu blob jako metadata.

Poznámka: Od verze 2009-09-19 musí názvy metadat dodržovat pravidla pojmenování pro identifikátory jazyka C#.
x-ms-encryption-scope Volitelný. Obor šifrování, který se má použít k šifrování obsahu požadavku. Tato hlavička je podporována ve verzi 2019-02-02 a novější.
x-ms-tags Volitelný. Nastaví zadané značky kódované řetězcem dotazu v objektu blob. Další informace najdete v části Poznámky. Podporováno ve verzi 2019-12-12 a novějších.
x-ms-copy-source-tag-option Volitelný. Možné hodnoty jsou REPLACE nebo COPY (rozlišují se malá a velká písmena). Výchozí hodnota je NAHRADIT.

Pokud je zadáno kopírování, značky ze zdrojového objektu blob se zkopírují 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 zdrojového objektu blob a Nastavit značky objektů blob v cílovém objektu blob. To způsobuje další volání operace Získání značek objektů blob zdrojového účtu.

FUNKCE REPLACE nastaví značky určené hlavičkou x-ms-tags cílového objektu blob. Pokud se použije funkce REPLACE a x-ms-tagsnezadáte žádné značky, v cílovém objektu blob se nenastaví žádné značky. Zadáním funkce COPY a x-ms-tags vznikne chyba 409 (Konflikt).

Podporováno ve verzi 2021-04-10 a novějších.
x-ms-copy-source-blob-properties Volitelný. Určuje chování vlastností zdrojového objektu blob 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 Volitelný. Hodnota DateTime. Tuto podmíněnou hlavičku zadejte tak, aby objekt blob umístil pouze v případě, že se zdrojový objekt blob od zadaného data a času změnil. Pokud se zdrojový objekt blob nezměnil, vrátí služba Blob Storage stavový kód 412 (předběžná podmínka se nezdařila). Tato hlavička se nedá zadat, pokud je zdrojem sdílená složka Azure Files.
x-ms-source-if-unmodified-since Volitelný. Hodnota DateTime. Tuto podmíněnou hlavičku zadejte tak, aby objekt blob umístil pouze v případě, že se zdrojový objekt blob od zadaného data a času nezměnil. Pokud byl zdrojový objekt blob změněn, vrátí blob Storage stavový kód 412 (předběžná podmínka se nezdařila). Tato hlavička se nedá zadat, pokud je zdrojem sdílená složka Azure Files.
x-ms-source-if-match Volitelný. Hodnota ETag. Tuto podmíněnou hlavičku zadejte, aby se zdrojový objekt blob umístil pouze v případě, že jeho značka ETag odpovídá zadané hodnotě. Pokud hodnoty ETag neodpovídají, vrátí blob Storage stavový kód 412 (předběžná podmínka se nezdařila). Tato hlavička se nedá zadat, pokud je zdrojem sdílená složka Azure Files.
x-ms-source-if-none-match Volitelný. Hodnota ETag. Tuto podmíněnou hlavičku zadejte tak, aby objekt blob umístil pouze v případě, že se jeho značka ETag neshoduje se zadanou hodnotou. Pokud jsou hodnoty identické, vrátí blob Storage stavový kód 412 (předběžná podmínka se nezdařila). Tato hlavička se nedá zadat, pokud je zdrojem sdílená složka Azure Files.
If-Modified-Since Volitelný. Hodnota DateTime. Tuto podmíněnou hlavičku zadejte tak, aby objekt blob umístil 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 Volitelný. Hodnota DateTime. Tuto podmíněnou hlavičku zadejte, aby se objekt blob umístil pouze v případě, že se cílový objekt blob od zadaného data a času nezměnil. Pokud byl cílový objekt blob změněn, vrátí blob Storage stavový kód 412 (předběžná podmínka se nezdařila).
If-Match Volitelný. Hodnota ETag. Zadejte hodnotu značky ETag pro toto podmíněné záhlaví, aby se objekt blob umístil pouze v případě, že zadaná hodnota značky ETag odpovídá ETag hodnotě existujícího cílového objektu blob. Pokud značky ETag cílového objektu blob neodpovídají značkě ETag zadané pro If-Match, vrátí blob Storage stavový kód 412 (předběžná podmínka se nezdařila).
If-None-Match Volitelný. Hodnota značky ETag nebo zástupný znak (*).

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

Zadejte zástupný znak (*) pro provedení operace 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 u objektu blob s aktivním zapůjčením, zadejte platné ID zapůjčení pro tuto hlavičku.
x-ms-blob-content-disposition Volitelný. Nastaví hlavičku Content-Disposition objektu blob. K dispozici pro verzi 2013-08-15 a novější.

Pole hlavičky odpovědi Content-Disposition 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 attachment, znamená to, že uživatel-agent by neměl zobrazit 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 Získání objektů blob a Získání vlastností objektu blob operace zahrnuje hlavičku content-disposition.
Origin Volitelný. Určuje původ, ze kterého je žádost vydána. Výsledkem přítomnosti této hlavičky jsou 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 Volitelný. Poskytuje klientem vygenerovanou neprůhlenou hodnotu s limitem znaků 1 kibibajtů (KiB), který je zaznamenán v analytických protokolech, když je povolené 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-access-tier Volitelný. Určuje úroveň, která se má nastavit v objektu blob. Platné hodnoty pro úrovně objektů blob bloku jsou Hot, Cool, Colda Archive. Poznámka: úroveň Cold je podporovaná pro verzi 2021–12-02 a novější. Hot, Coola Archive jsou podporované pro verzi 2018–11.09 a novější. Další informace o vrstvení objektů blob bloku najdete v tématu horké, studené a archivní úrovně úložiště.
x-ms-expiry-option Volitelný. Verze 2023-08-03 a novější. Určuje možnost data vypršení platnosti požadavku. Další informace naleznete v tématu Konec platnostiOption. Tato hlavička je platná pro účty s povoleným hierarchickým oborem názvů.
x-ms-expiry-time Volitelný. Verze 2023-08-03 a novější. Určuje čas, kdy je objekt blob nastavený na vypršení platnosti. Formát data vypršení platnosti se liší podle x-ms-expiry-option. Další informace naleznete v tématu Konec platnostiOption. 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 je možné zadat následující hlavičky pro šifrování objektu blob pomocí klíče poskytnutého zákazníkem. Š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 Požadovaný. Šifrovací klíč AES-256 s kódováním Base64.
x-ms-encryption-key-sha256 Požadovaný. Hodnota hash SHA256 s kódováním Base64 šifrovacího klíče.
x-ms-encryption-algorithm: AES256 Požadovaný. Určuje algoritmus, který se má použít pro š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 Stav a kódy chyb.

Hlavičky odpovědi

Odpověď pro tuto operaci obsahuje následující hlavičky. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Popis
ETag ETag obsahuje hodnotu, kterou může klient použít k provádění podmíněných PUT operací pomocí hlavičky požadavku If-Match. Hodnota ETag je 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 naleznete v tématu Reprezentace hodnot data a času v záhlavích.

Jakákoli operace zápisu 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á hodnota Content-MD5 se vypočítá službou Blob Storage. Tato hlavička se vrátí i v případě, že požadavek neobsahuje hlavičky Content-MD5 ani 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á hodnota x-ms-content-crc64 se vypočítá službou Blob Storage. Tato hlavička se vždy vrátí.
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á byla použita k provedení požadavku.
Date Hodnota data a času UTC vygenerovaná službou, která označuje čas zahájení odpovědi.
Access-Control-Allow-Origin Vrátí se, pokud požadavek obsahuje hlavičku Origin a CORS se povolí s odpovídajícím pravidlem. Pokud existuje shoda, vrátí tato hlavička hodnotu hlavičky požadavku původu.
Access-Control-Expose-Headers Vrátí se, pokud požadavek obsahuje hlavičku Origin a CORS se povolí s odpovídajícím pravidlem. Vrátí seznam hlaviček odpovědí, které mají být vystaveny 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 nastavena na false.
x-ms-encryption-key-sha256 Vrátí se, pokud požadavek použil k šifrování klíč poskytnutý zákazníkem, aby klient mohl zajistit, aby byl obsah požadavku úspěšně zašifrován pomocí poskytnutého klíče.
x-ms-encryption-scope Vrátí se, 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> Vrátí neprůhlenou 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 pro 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>

Oprávnění

Autorizace se vyžaduje při volání jakékoli operace přístupu k datům ve službě Azure Storage. Operaci Put Blob From URL můžete autorizovat, jak je popsáno níže.

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

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 vynikající zabezpečení a snadné použití v porovnání s autorizací sdíleného klíče.

Azure Storage podporuje použití Microsoft Entra ID k autorizaci požadavků na data objektů blob. S ID Microsoft Entra můžete pomocí řízení přístupu na základě role v Azure (Azure RBAC) udělit oprávnění k objektu zabezpečení. Objekt zabezpečení může být uživatel, skupina, instanční objekt aplikace nebo spravovaná identita Azure. Instanční objekt zabezpečení je ověřený pomocí ID Microsoft Entra pro vrácení tokenu OAuth 2.0. Token se pak dá použít k autorizaci požadavku ve službě Blob Service.

Další informace o autorizaci pomocí ID Microsoft Entra najdete v tématu Autorizace přístupu k objektům blob pomocíMicrosoft Entra ID .

Dovolení

Níže je uvedena akce RBAC potřebná pro uživatele, skupinu, spravovanou identitu nebo instanční objekt Microsoftu pro volání operace Put Blob From URL a nejméně privilegované předdefinované role Azure RBAC, 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 Blob From URL je podporována od verze 2020-04-08.

Ve verzi 2020-10-02 a novějších je autorizace Microsoft Entra podporována pro zdroj operace kopírování.

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

Operace Put Blob From URL vždy kopíruje celý zdrojový objekt blob. Kopírování rozsahu bajtů nebo sady bloků se nepodporuje. Pokud chcete provést částečné aktualizace, přečtěte si put Block From URL. Cílovým objektem blob může být existující objekt blob bloku nebo nový objekt blob vytvořený operací.

Při použití objektu blob bloku jako zdrojového objektu se zkopíruje veškerý potvrzený obsah objektu blob. Seznam blokovaných bloků se ale nezachová a nepotvrzené bloky se nezkopírují. Obsah cílového objektu blob je stejný jako obsah zdroje, ale potvrzený seznam bloků se nezachová.

umístit vlastnosti objektu blob a metadata

Při vytváření objektu blob bloku ze zdroje kopírování se ve výchozím nastavení zkopírují standardní vlastnosti objektu blob ze zdrojového objektu blob. Pokud jsou v požadavku zadána metadata aplikace, uloží se bez kopírování metadat zdrojového objektu blob. Pokud chcete explicitně nastavit 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 vždy odpovídá zdrojovému objektu blob. Hlavička Content-Length musí být v požadavku Put Blob From URL 0 (protože neexistuje text požadavku) a vlastnost délky 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 se řídí stejnou sémantikou 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ích vlastností objektu blob

značky indexu objektů blob

Pokud jsou značky pro cílový objekt blob zadané v hlavičce x-ms-tags, musí být kódovány řetězcem dotazu. Klíče a hodnoty značek musí odpovídat požadavkům na pojmenování a délku podle Set Blob Tags. Hlavička x-ms-tags navíc může obsahovat až 2 KiB značek. Pokud je vyžadováno více značek, použijte operaci Set Blob Tags.

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

rozsahy šifrování a klíče poskytované zákazníkem

Rozhraní Put Blob From URL API podporuje rozsahy šifrování i klíče poskytované zákazníkem pomocí x-ms-encryption-scope a hlaviček 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, operace Put Blob From URL provede synchronní místní přepsání objektu blob. To umožňuje přepsání objektu blob tak, aby používal jiný šifrovací klíč nebo obor šifrování.

Fakturování

Žádosti o ceny můžou pocházet z 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. Tyto žádosti nabíhají poplatky za transakci. Typ transakce ovlivňuje způsob účtování účtu. Například transakce čtení nabíhají do jiné fakturační kategorie než transakce zápisu. Následující tabulka uvádí kategorii fakturace pro požadavky Put Blob From URL na základě 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 verze 2
Standard pro obecné účely verze 1		 Operace zápisu
Vložení objektu blob z adresy URL (zdrojový účet2) Objekt blob bloku Úrovně Premium
Standard pro obecné účely verze 2
Standard pro obecné účely verze 1		 Operace čtení

1Cílový účet se účtuje za jednu transakci, která zahájí zápis.
2Zdrojový účet pro každý požadavek na čtení zdrojového objektu nese jednu transakci.

Kromě toho platí, že pokud se zdrojový a cílový účet nachází v různých oblastech (například USA – sever a USA – jih), bude se šířka pásma používaná k přenosu požadavku účtovat zdrojovému účtu úložiště jako výchozí. 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ě používá další prostředky úložiště, takže operace bude účtovat poplatky za využití kapacity účtu úložiště pro tyto další prostředky.

Další informace o cenách pro zadané fakturační kategorie najdete v tématu ceny služby Azure Blob Storage.

Viz také

autorizace požadavků na stav služby Azure Storagea kódy chybkódy chyb služby Blob ServiceNastavit časové limity pro operace služby Blob Service