Placera intervall från URL
Åtgärden Put Range From URL skapar ett nytt intervall som ska checkas in som en del av en fil där innehållet läse från en URL. Den här åtgärden stöds i version 2019-02-02 och senare för filresurser med SMB-protokoll aktiverat och stöds i version 2025-05-05 och senare för filresurser med NFS-protokoll aktiverat.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgänglig |
|---|---|
| SMB |
|
| NFS |
|
Begäran
Den Put Range From URL begäran skapas på följande sätt. Vi rekommenderar att du använder HTTPS.
| Metod | Begärande-URI | HTTP-version |
|---|---|---|
| STÄLLA | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=range |
HTTP/1.1 |
Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna enligt följande:
| Sökvägskomponent | Beskrivning |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
mydirectorypath |
Valfri. Sökvägen till den överordnade katalogen. |
myfile |
Namnet på filen. |
Information om namngivningsbegränsningar för sökvägar finns i Namn och referensresurser, kataloger, filer och metadata.
URI-parametrar
| Parameter | Beskrivning |
|---|---|
timeout |
Valfri. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Azure Files-åtgärder. |
Begärandehuvuden
De obligatoriska och valfria begäranderubrikerna beskrivs i följande tabeller:
Vanliga begärandehuvuden
| Begärandehuvud | Beskrivning |
|---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date eller x-ms-date |
Krävs. Anger UTC (Coordinated Universal Time) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Den här åtgärden stöds i version 2019-02-02 och senare för filresurser med SMB-protokoll aktiverat och stöds i version 2025-05-05 och senare för filresurser med NFS-protokoll aktiverat. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-copy-source:name |
Krävs. Anger källfilens URL. Värdet kan vara en URL på upp till 2 KiB som anger en fil. Värdet ska vara URL-kodat eftersom det visas i en begärande-URI. Källfilen måste antingen vara offentlig eller ha behörighet via en signatur för delad åtkomst. Om källfilen är offentlig krävs ingen auktorisering för att utföra åtgärden. Här är några exempel på url:er för källobjekt:
|
x-ms-copy-source-authorization: <scheme> <signature> |
Valfri. Anger auktoriseringsschemat och signaturen för kopieringskällan. Mer information finns i Auktorisera begäranden till Azure Storage. Endast systembäraren stöds för Microsoft Entra. Den här rubriken stöds i version 2020-10-02 och senare. |
x-ms-write: { update } |
Krävs. Du måste bara ange update. Begäran misslyckas om den anropas med clear. Värdet update skriver de byte som anges av begärandetexten till de angivna intervallen. |
Range eller x-ms-range |
Krävs. Antingen Range eller x-ms-range krävs.Anger det intervall med byte som ska skrivas. Både början och slutet av intervallet måste anges. Det här huvudet definieras av HTTP/1.1-protokollspecifikationen. För en uppdateringsåtgärd kan intervallet vara upp till 4 MiB i storlek. Azure Files accepterar endast ett enda byteintervall för Range- och x-ms-range-huvudena, och byteintervallet måste anges i följande format: bytes=startByte-endByte.Om både Range och x-ms-range anges använder tjänsten värdet för x-ms-range. Mer information finns i Ange intervallrubriken för Azure Files-åtgärder. |
x-ms-source-range |
Krävs. Anger det intervall med byte som ska läsas från källan. Både början och slutet av intervallet måste anges. Azure Files accepterar endast ett enda byteintervall för Range- och x-ms-range-huvudena, och byteintervallet måste anges i följande format: bytes=startByte-endByte.Källintervallet kan vara upp till 4 miB stort. Om källintervallets storlek överskrider 4 MiB returnerar Azure Files statuskod 413 (begärandeentiteten är för stor). Om källintervallets storlek inte matchar intervallstorleken (målintervallet) returnerar tjänsten statuskod 400 (felaktig begäran). |
Content-Length |
Krävs. Anger antalet byte som överförs i begärandetexten. Värdet för det här huvudet måste anges till 0. När längden inte är 0misslyckas åtgärden med statuskoden 400 (felaktig begäran). |
x-ms-client-request-id |
Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB) som registreras i loggarna när loggningen konfigureras. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Files-. |
x-ms-source-content-crc64 |
Valfri. En CRC64-hash för det angivna intervallet från URI:n. Den här hashen används för att verifiera integriteten för intervallet under transporten av data från URI:n. När det här huvudet har angetts jämför Azure Files hash-värdet för innehållet som har kommit från kopieringskällan med det här rubrikvärdet. Obs: Den här CRC64-hashen lagras inte med filen. Om de två hashvärdena inte matchar misslyckas åtgärden med felkoden 400 (felaktig begäran). |
x-ms-source-if-match-crc64 |
Valfri. Ett CRC64-kontrollsummavärde. Ange det här huvudet för att utföra åtgärden endast om kontrollsumman för det angivna intervallet som lästs från källan matchar från den angivna kontrollsumman. Om det angivna villkoret inte uppfylls returnerar Azure Files statuskod 412 (förhandsvillkoret misslyckades). |
x-ms-source-if-none-match-crc64 |
Valfri. Ett CRC64-kontrollsummavärde. Ange den här rubriken för att utföra åtgärden endast om kontrollsumman för det angivna intervallet som lästs från källan skiljer sig från den angivna kontrollsumman. Om det angivna villkoret inte uppfylls returnerar Azure Files statuskod 412 (förhandsvillkoret misslyckades). |
x-ms-lease-id: <ID> |
Krävs om filen har ett aktivt lån. Tillgänglig för version 2019-02-02 och senare. Det här huvudet ignoreras om filen finns på en filresurs med NFS-protokollet aktiverat, vilket inte stöder fillån. |
x-ms-client-request-id |
Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB), som registreras i analysloggarna när Azure Storage Analytics-loggning är aktiverad. Vi rekommenderar starkt att du använder det här huvudet när du korrelerar aktiviteter på klientsidan med begäranden som tas emot av servern. Mer information finns i Övervaka Blob Storage-. |
x-ms-file-last-write-time: { now ¦ preserve } |
Valfri. Version 2021-06-08 och senare. Du kan ange något av följande alternativ:
|
x-ms-file-request-intent |
Krävs om Authorization rubrik anger en OAuth-token. Acceptabelt värde är backup. Det här huvudet anger att Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action eller Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action ska beviljas om de ingår i RBAC-principen som tilldelats den identitet som är auktoriserad med hjälp av Authorization-huvudet. Tillgänglig för version 2022-11-02 och senare. |
x-ms-allow-trailing-dot: { <Boolean> } |
Valfri. Version 2022-11-02 och senare. Det booleska värdet anger om en avslutande punkt som finns i begärande-URL:en ska trimmas eller inte. Det här huvudet ignoreras om målet finns på en filresurs med NFS-protokollet aktiverat, vilket stöder avslutande punkt som standard. Mer information finns i Namngivning och referens av resurser, kataloger, filer och metadata. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Valfri. Version 2022-11-02 och senare. Det booleska värdet anger om en avslutande punkt som finns i käll-URL:en ska trimmas eller inte. Det här huvudet bör endast anges om kopieringskällan finns på en Azure-filresurs. Det här huvudet stöds inte för någon annan typ av kopieringskälla. Det här huvudet ignoreras om kopieringskällan finns på en filresurs med NFS-protokollet aktiverat, vilket stöder avslutande punkt som standard. Mer information finns i Namngivning och referens av resurser, kataloger, filer och metadata. |
Endast SMB-begärandehuvuden
Ingen.
Endast NFS-begärandehuvuden
Ingen.
Begärandetext
Ingen begärandetext.
Exempelbegäran
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
Svar
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskoden 201 (skapad). Mer information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller rubrikerna i följande tabeller. Svaret kan också innehålla ytterligare standard-HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
Vanliga svarshuvuden
| Svarsrubrik | Beskrivning |
|---|---|
ETag |
Innehåller ett värde som du kan använda för att utföra åtgärder villkorligt. Värdet omges av citattecken. |
Last-Modified |
Datum och tid då filen senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representation av datum-/tidsvärden i rubriker. Alla skrivåtgärder på filen, inklusive uppdateringar av filens metadata eller egenskaper, ändrar den senaste ändrade tiden för filen. |
x-ms-request-id |
Identifierar den begäran som gjordes unikt och du kan använda den för att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger den FileREST API-version som användes för att köra begäran. |
Date |
Ett UTC-datum/tid-värde som genereras av tjänsten, vilket anger den tid då svaret initierades. |
x-ms-content-crc64 |
Returneras så att klienten kan söka efter meddelandeinnehållsintegritet. Värdet för det här huvudet beräknas av Azure Files. Det är inte nödvändigtvis samma som värdet som anges i begäranderubrikerna. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id-huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om den x-ms-client-request-id rubriken inte finns i begäran visas den inte i svaret. |
x-ms-file-last-write-time |
Version 2021-06-08 och senare. Den senaste skrivtiden för filen i ISO 8601-format (till exempel 2017-05-10T17:52:33.9551861Z). |
Endast SMB-svarshuvuden
Ingen.
Endast NFS-svarshuvuden
Ingen.
Svarstext
Ingen.
Exempelsvar
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
Tillstånd
Endast kontoägaren kan anropa den här åtgärden.
Anmärkningar
Åtgärden Put Range From URL skriver ett dataintervall till en fil och liknar den Put Range åtgärden. Den använder åtgärden Get File på den angivna källan för att läsa data, metadata och andra egenskaper för källfilen. I version 2020-10-02 och senare stöds Microsoft Entra-auktorisering för kopieringsåtgärdens källa.
Åtgärden Put Range From URL returnerar framgång 201 (skapad) endast om det angivna intervallet skrivs till filen.