Placera intervall från URL

Artikel
05/15/2024

Å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. Det här API:et är tillgängligt från och med version 2019-02-02.

Protokolltillgänglighet

Aktiverat filresursprotokoll	Tillgängligt
SMB
NFS

Förfrågan

Begäran Put Range From URL kan konstrueras på följande sätt. Vi rekommenderar att du använder HTTPS. Ersätt myaccount med namnet på ditt lagringskonto:

Metod	URI för förfrågan	HTTP-version
`PUT`	`https://myaccount.file.core.windows.net/myshare/myfile?comp=range`	HTTP/1.1

URI-parametrar

Parameter	Beskrivning
`timeout`	Valfritt. 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 tabell:

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 Coordinated Universal Time (UTC) 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. Mer information finns i Versionshantering för Azure Storage-tjänsterna. För `Put Range From URL`måste versionen vara 2019-02-02 eller senare.
`x-ms-copy-source:name`	Krävs. Anger url:en för källfilen. 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: `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>`	Valfritt. Anger auktoriseringsschemat och signaturen för kopieringskällan. Mer information finns i Auktorisera begäranden till Azure Storage. Endast schemabäraren stöds för Microsoft Entra. Det här huvudet stöds i version 2020-10-02 och senare.
`x-ms-write: { update }`	Krävs. Du måste bara `update`ange . 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 byteintervall 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 intervall med en enda byte för `Range` huvudena och `x-ms-range` 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 `x-ms-range`. Mer information finns i Ange områdesrubriken för Azure Files åtgärder.
`x-ms-source-range`	Krävs. Anger intervallet för 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 intervall med en enda byte för `Range` huvudena och `x-ms-range` 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 intervallets storlek (målintervall) returnerar tjänsten statuskoden 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 `0`är misslyckas åtgärden med statuskoden 400 (felaktig begäran).
`x-ms-client-request-id`	Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. 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`	Valfritt. 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 anges jämför Azure Files hashen 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`	Valfritt. 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 statuskoden 412 (villkoret misslyckades).
`x-ms-source-if-none-match-crc64`	Valfritt. 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 skiljer sig från den angivna kontrollsumman. Om det angivna villkoret inte uppfylls returnerar Azure Files statuskoden 412 (villkoret misslyckades).
`x-ms-lease-id:<ID>`	Krävs om filen har ett aktivt lån. Om du vill utföra den här åtgärden på en fil med ett aktivt lån anger du det giltiga låne-ID:t för det här huvudet.
`x-ms-client-request-id`	Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB), som registreras i analysloggarna när Azure Lagringsanalys 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 }`	Valfritt. Version 2021-06-08 och senare. Du kan ange något av följande alternativ: `now`:Standardvärdet. Uppdateringar tidsstämpeln för senaste skrivtid till tiden för begäran. `preserve`: Håller den befintliga tidsstämpeln för senaste skrivning oförändrad.
`x-ms-file-request-intent`	Krävs om `Authorization` huvudet 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 DEN RBAC-princip som tilldelats den identitet som har behörighet med hjälp av `Authorization` huvudet. Tillgänglig för version 2022-11-02 och senare.
`x-ms-allow-trailing-dot: { <Boolean> }`	Valfritt. 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. Mer information finns i Namnge och referera till resurser, kataloger, filer och metadata.
`x-ms-source-allow-trailing-dot: { <Boolean> }`	Valfritt. 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. Den här rubriken ska endast anges om kopieringskällan är en Azure-fil. Det här huvudet stöds inte för någon annan typ av kopieringskälla. Mer information finns i Namnge och referera till resurser, kataloger, filer och metadata.

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

Svarsåtgärder

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 följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.

Svarsrubrik	Description
`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 of Date/Time Values in headers (Representation av datum-/tidsvärden i rubriker). Alla skrivåtgärder i filen, inklusive uppdateringar av filens metadata eller egenskaper, ändrar den senaste ändringstiden för filen.
`x-ms-request-id`	Identifierar 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 DATUM-/tidsvärde för UTC som genereras av tjänsten, vilket anger den tid då svaret initierades.
`x-ms-content-crc64`	Returneras så att klienten kan söka efter meddelandets innehållsintegritet. Värdet för den här rubriken beräknas av Azure Files. Det är inte nödvändigtvis samma som värdet som anges i begärandehuvudena.
`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 `x-ms-client-request-id` för rubriken om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om rubriken `x-ms-client-request-id` inte finns i begäran finns 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`).

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

Auktorisering

Den här åtgärden kan anropas av kontoägaren och av alla som har en signatur för delad åtkomst med behörighet att skriva till den här filen eller Azure-filresursen.

Kommentarer

Åtgärden Put Range From URL skriver ett dataområde till en fil. Om API:et anropas på en fil som inte finns på målet returnerar API:et HTTP-statuskod 404 (hittades inte).

I version 2020-10-02 och senare stöds Microsoft Entra auktorisering för kopieringsåtgärdens källa.

Om du vill skapa en ny fil anropar du Create File.

Put Range From URL åtgärden returnerar framgång 201 (skapad) endast om det angivna intervallet skrivs till filen.

Filläsningsåtgärd
Put Range From URL använder Get File för att läsa data och metadata, attribut och ACL:er från källan.

Filuppdateringsåtgärd
Om du anropar Put Range From URL med alternativet "uppdatera" utförs en skrivning på plats på den angivna filen. Allt innehåll i den angivna filen skrivs över med uppdateringen.  

Intervallstorleken Put Range From URL i åtgärden för en uppdateringsåtgärd kan vara upp till 4 MiB i storlek. Om du försöker ladda upp ett intervall som är större än 4 MiB returnerar Azure Files statuskod 413 (RequestEntityTooLarge).

Share via