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 |
|---|---|
| SMB |
|
| 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 |
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:
|
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í:
|
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