Bereik van URL plaatsen
Met de bewerking Put Range From URL wordt een nieuw bereik gemaakt dat moet worden doorgevoerd als onderdeel van een bestand waarin de inhoud wordt gelezen uit een URL. Deze bewerking wordt ondersteund in versie 2019-02-02 en hoger voor bestandsshares waarvoor SMB-protocol is ingeschakeld en ondersteund in versie 2025-05-05 en hoger voor bestandsshares waarvoor het NFS-protocol is ingeschakeld.
Beschikbaarheid van protocol
| Protocol voor bestandsshare ingeschakeld | Beschikbaar |
|---|---|
| SMB |
|
| NFS |
|
Verzoek
De Put Range From URL aanvraag wordt als volgt samengesteld. U wordt aangeraden HTTPS te gebruiken.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| ZETTEN | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=range |
HTTP/1.1 |
Vervang de padonderdelen in de aanvraag-URI als volgt door uw eigen padonderdelen:
| Padonderdeel | Beschrijving |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van uw bestandsshare. |
mydirectorypath |
Facultatief. Het pad naar de bovenliggende map. |
myfile |
De naam van het bestand. |
Zie Naam- en referentieshares, mappen, bestanden en metagegevensvoor meer informatie over naamgevingsbeperkingen voor paden.
URI-parameters
| Parameter | Beschrijving |
|---|---|
timeout |
Facultatief. De parameter timeout wordt uitgedrukt in seconden. Zie Time-outs instellen voor Azure Files-bewerkingenvoor meer informatie. |
Aanvraagheaders
De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabellen:
Algemene aanvraagheaders
| Aanvraagheader | Beschrijving |
|---|---|
Authorization |
Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storage- voor meer informatie. |
Date of x-ms-date |
Vereist. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Deze bewerking wordt ondersteund in versie 2019-02-02 en hoger voor bestandsshares waarvoor SMB-protocol is ingeschakeld en ondersteund in versie 2025-05-05 en hoger voor bestandsshares waarvoor het NFS-protocol is ingeschakeld. Zie Versiebeheer voor de Azure Storage-servicesvoor meer informatie. |
x-ms-copy-source:name |
Vereist. Hiermee geeft u de URL van het bronbestand. De waarde kan een URL zijn van maximaal 2 KiB in lengte die een bestand aangeeft. De waarde moet URL-gecodeerd zijn, zoals deze wordt weergegeven in een aanvraag-URI. Het bronbestand moet openbaar zijn of moeten worden geautoriseerd via een handtekening voor gedeelde toegang. Als het bronbestand openbaar is, is er geen autorisatie vereist om de bewerking uit te voeren. Hier volgen enkele voorbeelden van URL's voor bronobjecten:
|
x-ms-copy-source-authorization: <scheme> <signature> |
Facultatief. Hiermee geeft u het autorisatieschema en de handtekening voor de kopieerbron. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie. Alleen de schemabeer wordt ondersteund voor Microsoft Entra. Deze header wordt ondersteund in versie 2020-10-02 en hoger. |
x-ms-write: { update } |
Vereist. U moet alleen updateopgeven. De aanvraag mislukt als deze wordt aangeroepen met clear. De update waarde schrijft de bytes die zijn opgegeven door de aanvraagbody in de opgegeven bereiken. |
Range of x-ms-range |
Vereist.
Range of x-ms-range is vereist.Hiermee geeft u het bereik van bytes dat moet worden geschreven. Zowel het begin als het einde van het bereik moet worden opgegeven. Deze header wordt gedefinieerd door de HTTP/1.1-protocolspecificatie. Voor een updatebewerking kan het bereik maximaal 4 MiB groot zijn. Azure Files accepteert slechts één bytebereik voor de Range- en x-ms-range-headers en het bytebereik moet worden opgegeven in de volgende indeling: bytes=startByte-endByte.Als zowel Range als x-ms-range zijn opgegeven, gebruikt de service de waarde van x-ms-range. Zie Geef de bereikheader op voor Azure Files-bewerkingenvoor meer informatie. |
x-ms-source-range |
Vereist. Hiermee geeft u het bereik van bytes dat moet worden gelezen uit de bron. Zowel het begin als het einde van het bereik moet worden opgegeven. Azure Files accepteert slechts één bytebereik voor de Range- en x-ms-range-headers en het bytebereik moet worden opgegeven in de volgende indeling: bytes=startByte-endByte.Het bronbereik kan maximaal 4 MiB groot zijn. Als de grootte van het bronbereik groter is dan 4 MiB, retourneert Azure Files statuscode 413 (Aanvraagentiteit te groot). Als de grootte van het bronbereik niet overeenkomt met de grootte van het bereik (doelbereik), retourneert de service statuscode 400 (Ongeldige aanvraag). |
Content-Length |
Vereist. Hiermee geeft u het aantal bytes dat wordt verzonden in de aanvraagbody. De waarde van deze header moet worden ingesteld op 0. Wanneer de lengte niet 0, mislukt de bewerking met de statuscode 400 (Ongeldige aanvraag). |
x-ms-client-request-id |
Facultatief. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Monitor Azure Filesvoor meer informatie. |
x-ms-source-content-crc64 |
Facultatief. Een CRC64-hash van het opgegeven bereik van de URI. Deze hash wordt gebruikt om de integriteit van het bereik te controleren tijdens het transport van de gegevens van de URI. Wanneer deze header is opgegeven, vergelijkt Azure Files de hash van de inhoud die afkomstig is van de copy-source met deze headerwaarde. Opmerking: deze CRC64-hash wordt niet met het bestand opgeslagen. Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (Ongeldige aanvraag). |
x-ms-source-if-match-crc64 |
Facultatief. Een CRC64-controlesomwaarde. Geef deze header op om de bewerking alleen uit te voeren als de controlesom van het opgegeven bereik uit de bronovereenkomsten uit de opgegeven controlesom leest. Als niet aan de opgegeven voorwaarde wordt voldaan, retourneert Azure Files statuscode 412 (Voorwaarde mislukt). |
x-ms-source-if-none-match-crc64 |
Facultatief. Een CRC64-controlesomwaarde. Geef deze header op om de bewerking alleen uit te voeren als de controlesom van het opgegeven bereik dat is gelezen uit de bron verschilt van de opgegeven controlesom. Als niet aan de opgegeven voorwaarde wordt voldaan, retourneert Azure Files statuscode 412 (Voorwaarde mislukt). |
x-ms-lease-id: <ID> |
Vereist als het bestand een actieve lease heeft. Beschikbaar voor versie 2019-02-02 en hoger. Deze header wordt genegeerd als het bestand zich op een bestandsshare bevindt waarvoor het NFS-protocol is ingeschakeld, wat geen ondersteuning biedt voor bestandsleases. |
x-ms-client-request-id |
Facultatief. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet van 1 kibibyte (KiB), die wordt vastgelegd in de analyselogboeken wanneer Logboekregistratie van Azure Storage Analytics is ingeschakeld. We raden u ten zeerste aan deze header te gebruiken wanneer u activiteiten aan de clientzijde correleert met aanvragen die door de server worden ontvangen. Zie Blob Storage-controleren voor meer informatie. |
x-ms-file-last-write-time: { now ¦ preserve } |
Facultatief. Versie 2021-06-08 en hoger. U kunt een van de volgende opties opgeven:
|
x-ms-file-request-intent |
Vereist als Authorization header een OAuth-token opgeeft. Acceptabele waarde is backup. Deze header geeft aan dat de Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action of Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action moeten worden verleend als ze zijn opgenomen in het RBAC-beleid dat is toegewezen aan de identiteit die is geautoriseerd met behulp van de Authorization-header. Beschikbaar voor versie 2022-11-02 en hoger. |
x-ms-allow-trailing-dot: { <Boolean> } |
Facultatief. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een volgpunt aanwezig in de aanvraag-URL moet worden ingekort of niet. Deze header wordt genegeerd als het doel zich op een bestandsshare bevindt waarvoor het NFS-protocol is ingeschakeld. Dit biedt standaard ondersteuning voor een volgpunt. Zie Shares, mappen, bestanden en metagegevensvoor meer informatie. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Facultatief. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een volgpunt in de bron-URL moet worden ingekort of niet. Deze header moet alleen worden opgegeven als de kopieerbron zich op een Azure-bestandsshare bevindt. Deze header wordt niet ondersteund voor een ander kopieerbrontype. Deze header wordt genegeerd als de kopieerbron zich op een bestandsshare bevindt waarvoor het NFS-protocol is ingeschakeld. Dit biedt standaard ondersteuning voor een volgpunt. Zie Shares, mappen, bestanden en metagegevensvoor meer informatie. |
Alleen aanvraagheaders voor SMB
Geen.
Alleen aanvraagheaders voor NFS
Geen.
Aanvraagbody
Geen aanvraagbody.
Voorbeeldaanvraag
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
Antwoord
Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.
Statuscode
Een geslaagde bewerking retourneert statuscode 201 (gemaakt). Zie Status en foutcodesvoor meer informatie over statuscodes.
Antwoordheaders
Het antwoord voor deze bewerking bevat de headers in de volgende tabellen. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
Algemene antwoordheaders
| Antwoordheader | Beschrijving |
|---|---|
ETag |
Bevat een waarde die u kunt gebruiken om bewerkingen voorwaardelijk uit te voeren. De waarde staat tussen aanhalingstekens. |
Last-Modified |
De datum en tijd waarop het bestand het laatst is gewijzigd. De datumnotatie volgt RFC 1123. Zie Weergave van datum-/tijdwaarden in koptekstenvoor meer informatie. Elke schrijfbewerking op het bestand, inclusief updates van de metagegevens of eigenschappen van het bestand, wijzigt de laatste wijzigingstijd van het bestand. |
x-ms-request-id |
Identificeer de aanvraag die is gedaan en u kunt deze gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossenvoor meer informatie. |
x-ms-version |
Geeft de FileREST API-versie aan die is gebruikt om de aanvraag uit te voeren. |
Date |
Een UTC-datum/tijdwaarde die wordt gegenereerd door de service, wat de tijd aangeeft waarop het antwoord is gestart. |
x-ms-content-crc64 |
Geretourneerd zodat de client kan controleren op integriteit van berichtinhoud. De waarde van deze header wordt berekend door Azure Files. Dit is niet noodzakelijkerwijs hetzelfde als de waarde die is opgegeven in de aanvraagheaders. |
x-ms-client-request-id |
Kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header als deze aanwezig is in de aanvraag en de waarde niet meer dan 1024 zichtbare ASCII-tekens bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord. |
x-ms-file-last-write-time |
Versie 2021-06-08 en hoger. De laatste schrijftijd voor het bestand, in ISO 8601-indeling (bijvoorbeeld 2017-05-10T17:52:33.9551861Z). |
Alleen SMB-antwoordheaders
Geen.
Alleen antwoordheaders van NFS
Geen.
Hoofdtekst van antwoord
Geen.
Voorbeeldantwoord
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
Machtiging
Alleen de accounteigenaar kan deze bewerking aanroepen.
Opmerkingen
De Put Range From URL bewerking schrijft een reeks gegevens naar een bestand en is vergelijkbaar met het gedrag van de Put Range bewerking. Het maakt gebruik van de Get File bewerking op de opgegeven bron om gegevens, metagegevens en andere eigenschappen van het bronbestand te lezen. In versie 2020-10-02 en hoger wordt Microsoft Entra-autorisatie ondersteund voor de bron van de kopieerbewerking.
De Put Range From URL-bewerking retourneert alleen geslaagd 201 (gemaakt) als het opgegeven bereik naar het bestand wordt geschreven.