Bereik van URL plaatsen
Met Put Range From URL de bewerking wordt een nieuw bereik gemaakt dat moet worden doorgevoerd als onderdeel van een bestand waarin de inhoud van een URL wordt gelezen. Deze API is beschikbaar vanaf versie 2019-02-02.
Protocol beschikbaarheid
| Bestandsshareprotocol ingeschakeld | Beschikbaar |
|---|---|
| SMB |
|
| NFS |
|
Aanvraag
De Put Range From URL aanvraag kan als volgt worden samengesteld. U wordt aangeraden HTTPS te gebruiken. Vervang myaccount door de naam van uw opslagaccount:
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/myfile?comp=range |
HTTP/1.1 |
URI-parameters
| Parameter | Beschrijving |
|---|---|
timeout |
Optioneel. De timeout parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor Azure Files-bewerkingen voor meer informatie. |
Aanvraagheaders
De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabel:
| 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. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie. Voor Put Range From URLmoet de versie 2019-02-02 of hoger zijn. |
x-ms-copy-source:name |
Vereist. Hiermee geeft u de URL van het bronbestand. De waarde kan een URL van maximaal 2 KiB zijn die een bestand aangeeft. De waarde moet URL-gecodeerd zijn zoals deze wordt weergegeven in een aanvraag-URI. Het bronbestand moet openbaar zijn of worden geautoriseerd via een shared access signature. Als het bronbestand openbaar is, is er geen autorisatie vereist om de bewerking uit te voeren. Hier volgen enkele voorbeelden van bronobject-URL's:
|
x-ms-copy-source-authorization: <scheme> <signature> |
Optioneel. Hiermee geeft u het autorisatieschema en de handtekening voor de kopieerbron op. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie. Alleen de schemadrager 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 naar de opgegeven bereiken. |
Range of x-ms-range |
Vereist.
x-ms-range Of Range is vereist.Hiermee geeft u het bereik van bytes moet worden geschreven. Zowel het begin als het einde van het bereik moeten 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 kopteksten en x-ms-range en het bytebereik moet worden opgegeven in de volgende indeling: bytes=startByte-endByte.Als beide Range en x-ms-range zijn opgegeven, gebruikt de service de waarde van x-ms-range. Zie De bereikheader opgeven voor Azure Files bewerkingen voor 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 moeten worden opgegeven. Azure Files accepteert slechts één bytebereik voor de Range kopteksten en x-ms-range 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. Als de lengte niet 0is, mislukt de bewerking met de statuscode 400 (Ongeldige aanvraag). |
x-ms-client-request-id |
Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet 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 Azure Files bewaken voor meer informatie. |
x-ms-source-content-crc64 |
Optioneel. 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 uit 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 samen met het bestand opgeslagen. Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (ongeldige aanvraag). |
x-ms-source-if-match-crc64 |
Optioneel. Een CRC64-controlesomwaarde. Geef deze header op om de bewerking alleen uit te voeren als de controlesom van het opgegeven bereik uit de bron overeenkomt met de opgegeven controlesom. Als niet aan de opgegeven voorwaarde wordt voldaan, retourneert Azure Files statuscode 412 (Voorwaarde mislukt). |
x-ms-source-if-none-match-crc64 |
Optioneel. Een CRC64-controlesomwaarde. Geef deze header op om de bewerking alleen uit te voeren als de controlesom van het opgegeven bereik voor lezen uit 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. Als u deze bewerking wilt uitvoeren op een bestand met een actieve lease, geeft u de geldige lease-id voor deze header op. |
x-ms-client-request-id |
Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB), die wordt vastgelegd in de analyselogboeken wanneer Azure Opslaganalyse-logboekregistratie 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 bewaken voor meer informatie. |
x-ms-file-last-write-time: { now ¦ preserve } |
Optioneel. Versie 2021-06-08 en hoger. U kunt een van de volgende opties opgeven:
|
x-ms-file-request-intent |
Vereist als Authorization de 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 moet worden verleend als deze 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> } |
Optioneel. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een volgpunt in de aanvraag-URL moet worden ingekort of niet. Zie Shares, mappen, bestanden en metagegevens een naam geven en hiernaar verwijzen voor meer informatie. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Optioneel. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een afsluitende punt die aanwezig is in de bron-URL moet worden bijgesneden of niet. Deze header moet alleen worden opgegeven als de kopieerbron een Azure-bestand is. Deze koptekst wordt niet ondersteund voor een ander type kopieerbron. Zie Shares, mappen, bestanden en metagegevens een naam geven en hiernaar verwijzen voor meer informatie. |
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 foutcodes voor meer informatie over statuscodes.
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Description |
|---|---|
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 voor het laatst is gewijzigd. De datumnotatie volgt RFC 1123. Zie Weergave van datum-/tijdwaarden in kopteksten voor 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 |
Identificeert op unieke wijze de aanvraag die is gedaan en u kunt deze gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie. |
x-ms-version |
Geeft de Api-versie van FileREST aan die is gebruikt om de aanvraag uit te voeren. |
Date |
Een UTC-datum/tijd-waarde die wordt gegenereerd door de service, die de tijd aangeeft waarop het antwoord is gestart. |
x-ms-content-crc64 |
Geretourneerd, zodat de client de integriteit van de berichtinhoud kan controleren. 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). |
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
Autorisatie
Deze bewerking kan worden aangeroepen door de accounteigenaar en door iedereen met een shared access signature met machtigingen om naar dit bestand of de Azure-bestandsshare te schrijven.
Opmerkingen
Met de Put Range From URL bewerking wordt een gegevensbereik naar een bestand geschreven. Als de API wordt aangeroepen voor een niet-bestaand bestand op het doel, retourneert de API HTTP-statuscode 404 (Niet gevonden).
In versie 2020-10-02 en hoger wordt Microsoft Entra autorisatie ondersteund voor de bron van de kopieerbewerking.
Als u een nieuw bestand wilt maken, roept u Create Fileaan.
Put Range From URL bewerking retourneert alleen geslaagd 201 (gemaakt) als het opgegeven bereik naar het bestand is geschreven.
Bewerking voor het lezen van bestanden
Put Range From URL gebruikt Get File om gegevens en metagegevens, kenmerken en ACL's uit de bron te lezen.
Bestandsupdatebewerking
Aanroepen Put Range From URL met de optie 'bijwerken' voert een in-place schrijfbewerking uit op het opgegeven bestand. Alle inhoud in het opgegeven bestand wordt overschreven met de update.
De bereikgrootte in de Put Range From URL bewerking voor een updatebewerking kan maximaal 4 MiB groot zijn. Als u probeert een bereik te uploaden dat groter is dan 4 MiB, retourneert Azure Files statuscode 413 (RequestEntityTooLarge).