Umístění rozsahu z adresy URL

Operace Put Range From URL vytvoří nový rozsah, který se potvrdí jako součást souboru, ve kterém se obsah načte z adresy URL. Tato operace se podporuje ve verzi 2019-02-02 a novější pro sdílené složky s povoleným protokolem SMB a podporuje se ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS.

Dostupnost protokolu

Povolený protokol sdílené složky	K dispozici
Malé a střední podniky (MSP)
Síťový souborový systém (NFS)

Prosba

Požadavek Put Range From URL je vytvořen následujícím způsobem. Doporučujeme používat PROTOKOL HTTPS.

Metoda	Identifikátor URI požadavku	Verze HTTP
DÁT	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=range	Protokol HTTP/1.1

Součásti cesty zobrazené v identifikátoru URI požadavku nahraďte vlastními, a to následujícím způsobem:

Komponenta Path	Popis
myaccount	Název vašeho účtu úložiště.
myshare	Název sdílené složky.
mydirectorypath	Volitelný. Cesta k nadřazeného adresáři.
myfile	Název souboru.

Informace o omezeních pojmenování cest najdete v tématu Název a referenční sdílené složky, adresáře, soubory a metadata.

Parametry identifikátoru URI

Parametr	Popis
timeout	Volitelný. Parametr timeout se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace azure Files.

Hlavičky požadavku

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

Běžné hlavičky požadavků

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. Tato operace se podporuje ve verzi 2019-02-02 a novější pro sdílené složky s povoleným protokolem SMB a podporuje se ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-copy-source:name	Požadovaný. Určuje adresu URL zdrojového souboru. Hodnota může být adresa URL o délce až 2 KiB, která určuje soubor. Hodnota by měla být zakódovaná jako adresa URL, jak by se zobrazovala v identifikátoru URI požadavku. Zdrojový soubor musí být buď veřejný, nebo musí být autorizovaný prostřednictvím sdíleného přístupového podpisu. Pokud je zdrojový soubor veřejný, k provedení operace se nevyžaduje žádná autorizace. Tady je několik příkladů adres URL zdrojového objektu: https://myaccount.file.core.windows.net/myshare/mydir/myfile https://myaccount.file.core.windows.net/myshare/mydir/myfile?<sastoken>
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. Microsoft Entra podporuje pouze bearer schématu. Tato hlavička je podporována ve verzi 2020-10-02 a novější.
x-ms-write: { update }	Požadovaný. Je nutné zadat pouze update. Požadavek selže, pokud je volána pomocí clear. Hodnota update zapisuje bajty určené textem požadavku do zadaných oblastí.
Range nebo x-ms-range	Požadovaný. Vyžaduje se Range nebo x-ms-range. Určuje rozsah bajtů, které se mají zapsat. Musí být zadán začátek i konec rozsahu. Tato hlavička je definována specifikace protokolu HTTP/1.1. U operace aktualizace může mít velikost až 4 MiB. Služba Soubory Azure přijímá pouze jeden rozsah bajtů pro hlavičky Range a x-ms-range a rozsah bajtů musí být zadán v následujícím formátu: bytes=startByte-endByte. Pokud jsou zadány Range i x-ms-range, služba použije hodnotu x-ms-range. Další informace najdete v tématu Určení hlavičky rozsahu pro operace Azure Files.
x-ms-source-range	Požadovaný. Určuje rozsah bajtů, které se mají číst ze zdroje. Musí být zadán začátek i konec rozsahu. Služba Soubory Azure přijímá pouze jeden rozsah bajtů pro hlavičky Range a x-ms-range a rozsah bajtů musí být zadán v následujícím formátu: bytes=startByte-endByte. Zdrojový rozsah může mít velikost až 4 MiB. Pokud velikost zdrojového rozsahu překročí 4 MiB, azure Files vrátí stavový kód 413 (entita požadavku je příliš velká). Pokud velikost zdrojového rozsahu neodpovídá velikosti rozsahu (cílového rozsahu), vrátí služba stavový kód 400 (Chybný požadavek).
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 nastavena na 0. Pokud délka není 0, operace selže se stavovým kódem 400 (Chybný požadavek).
x-ms-client-request-id	Volitelný. Poskytuje hodnotu vygenerovanou klientem, neprůshlenou hodnotou s limitem znaků 1 kibibajtů (KiB), který je zaznamenán v protokolech 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 Monitorování služby Azure Files.
x-ms-source-content-crc64	Volitelný. Hodnota hash CRC64 zadaného rozsahu od identifikátoru URI. Tato hodnota hash se používá k ověření integrity rozsahu během přenosu dat z identifikátoru URI. Pokud je tato hlavička zadaná, Azure Files porovná hodnotu hash obsahu, který přišel ze zdroje kopírování, s touto hodnotou hlavičky. Poznámka: Tato hodnota hash CRC64 není uložena se souborem. Pokud se dvě hodnoty hash neshoduje, operace selže s kódem chyby 400 (Chybný požadavek).
x-ms-source-if-match-crc64	Volitelný. Hodnota kontrolního součtu CRC64. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že kontrolní součet daného rozsahu načteného ze zdroje odpovídá zadanému kontrolnímu součtu. Pokud zadaná podmínka není splněná, vrátí služba Azure Files stavový kód 412 (předběžná podmínka se nezdařila).
x-ms-source-if-none-match-crc64	Volitelný. Hodnota kontrolního součtu CRC64. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že se kontrolní součet daného rozsahu čtení ze zdroje liší od zadaného kontrolního součtu. Pokud zadaná podmínka není splněná, vrátí služba Azure Files stavový kód 412 (předběžná podmínka se nezdařila).
x-ms-lease-id: <ID>	Vyžaduje se, pokud má soubor aktivní zapůjčení. K dispozici pro verzi 2019-02-02 a novější. Tato hlavička se ignoruje, pokud je soubor umístěný ve sdílené složce s povoleným protokolem NFS, který nepodporuje zapůjčení souborů.
x-ms-client-request-id	Volitelný. Poskytuje hodnotu vygenerovanou klientem s 1 kibibajtům (KiB), která se zaznamenává v analytických protokolech, když je povolené protokolování Analýzy služby Azure Storage. Důrazně doporučujeme použít tuto hlavičku při korelaci aktivit na straně klienta s požadavky přijatými serverem. Další informace najdete v tématu Monitorováníslužby Blob Storage .
x-ms-file-last-write-time: { now ¦ preserve }	Volitelný. Verze 2021-06-08 a novější Můžete zadat jednu z následujících možností: now: Výchozí hodnota. Aktualizuje časové razítko času posledního zápisu na čas požadavku. preserve: Zachová stávající časové razítko posledního zápisu beze změny.
x-ms-file-request-intent	Vyžaduje se, pokud hlavička Authorization určuje token OAuth. Přijatelná hodnota je backup. Tato hlavička určuje, že Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action by měly být uděleny, pokud jsou zahrnuty do zásad RBAC přiřazené k identitě, která je autorizovaná pomocí hlavičky Authorization. K dispozici pro verzi 2022-11-02 a novější.
x-ms-allow-trailing-dot: { <Boolean> }	Volitelný. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli by se měla oříznout koncová tečka v adrese URL požadavku, nebo ne. Tato hlavička se ignoruje, pokud se cíl nachází ve sdílené složce s povoleným protokolem NFS, který ve výchozím nastavení podporuje koncové tečky. Další informace najdete v tématu Pojmenování a odkazování na sdílené složky, adresáře, soubory a metadata.
x-ms-source-allow-trailing-dot: { <Boolean> }	Volitelný. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli má být koncové tečky ve zdrojové adrese URL oříznuté nebo ne. Tato hlavička by se měla zadat jenom v případě, že zdroj kopírování je umístěný ve sdílené složce Azure. Tato hlavička není podporována pro žádný jiný typ zdroje kopírování. Tato hlavička se ignoruje, pokud je zdroj kopírování umístěný ve sdílené složce s povoleným protokolem NFS, který ve výchozím nastavení podporuje koncové tečky. Další informace najdete v tématu Pojmenování a odkazování na sdílené složky, adresáře, soubory a metadata.

Hlavičky požadavků jenom smb

Žádný.

Pouze hlavičky požadavků NFS

Žádný.

Text požadavku

Žádný text požadavku.

Ukázkový požadavek

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare/mydir/myfile?comp=range HTTP/1.1  
  
Request Headers:  
x-ms-page-write: update  
x-ms-copy-source: http://myaccount2.file.core.windows.net/myshare2/mydirectory2/myfile2?sv=2018-11-09&sp=r&sr=s&se=2018-08-22T09%3A59%3A28.2185790Z&sig=Qn6QEET3Gn%2FhCEVcXuwG7ssatIYiYRM5pNIy4Q3N0cQ%3D 
x-ms-date: Fri, 22 Aug 2018 01:15:50 GMT  
x-ms-version: 2019-02-02 
x-ms-range: bytes=100-1023  
x-ms-source-range: bytes=200-1123  
x-ms-source-content-crc64: 3bedb8b3730fc205 
Authorization: SharedKey myaccount:4KdWDiTdA9HmIF9+WF/8WfYOpUrFhieGIT7f0av+GEI=  
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 zahrnuje hlavičky v následujících tabulkách. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Běžná hlavička odpovědi

Hlavička odpovědi	Popis
ETag	Obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. Hodnota je uzavřena v uvozovkách.
Last-Modified	Datum a čas poslední změny souboru. 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 v souboru, včetně aktualizací metadat nebo vlastností souboru, změní čas poslední změny souboru.
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 rozhraní FileREST API, 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.
x-ms-content-crc64	Vráceno, aby klient mohl zkontrolovat integritu obsahu zpráv. Hodnota této hlavičky se počítá službou Azure Files. Nemusí se nutně shodovat s hodnotou zadanou v hlavičce požadavku.
x-ms-client-request-id	Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě hlavičky x-ms-client-request-id, pokud se nachází v požadavku a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud v požadavku není hlavička x-ms-client-request-id, nezobrazí se v odpovědi.
x-ms-file-last-write-time	Verze 2021-06-08 a novější Čas posledního zápisu souboru ve formátu ISO 8601 (například 2017-05-10T17:52:33.9551861Z).

Hlavičky odpovědi pouze smb

Žádný.

Pouze hlavičky odpovědi NFS

Žádný.

Text odpovědi

Žádný.

Ukázková odpověď

Response Status:  
HTTP/1.1 201 Created  

Response Headers:
Date: Sun, 22 Aug 2020 01:33:35 GMT  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: Wed, 22 Aug 2020 01:13:31 GMT  
x-ms-version: 2019-02-02
x-ms-content-crc64: 3bedb8b3730fc205 
Content-Length: 0  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  

Oprávnění

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Operace Put Range From URL zapisuje do souboru rozsah dat a podobá se chování operace Put Range. Používá operaci Get File pro zadaný zdroj ke čtení dat, metadat a dalších vlastností zdrojového souboru. Ve verzi 2020-10-02 a novějších je autorizace Microsoft Entra podporována pro zdroj operace kopírování.

Operace Put Range From URL vrátí úspěch 201 (vytvořeno) pouze v případě, že je zadaný rozsah zapsán do souboru.

Viz také

Operace se soubory