Bereich von URL einfügen
Der vorgang Put Range From URL erstellt einen neuen Bereich, der als Teil einer Datei, in der der Inhalt aus einer URL gelesen wird, zugesichert werden soll. Dieser Vorgang wird in Version 2019-02-02 und höher für Dateifreigaben mit aktiviertem SMB-Protokoll unterstützt und in Version 2025-05-05 und höher für Dateifreigaben mit aktiviertem NFS-Protokoll unterstützt.
Protokollverfügbarkeit
| Aktiviertes Dateifreigabeprotokoll | Verfügbar |
|---|---|
| SMB |
|
| NFS |
|
Bitten
Die Put Range From URL Anforderung wird wie folgt erstellt. Es wird empfohlen, HTTPS zu verwenden.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| STELLEN | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=range |
HTTP/1.1 |
Ersetzen Sie die pfadkomponenten, die im Anforderungs-URI angezeigt werden, wie folgt:
| Pfadkomponente | Beschreibung |
|---|---|
myaccount |
Der Name Ihres Speicherkontos. |
myshare |
Der Name Ihrer Dateifreigabe. |
mydirectorypath |
Wahlfrei. Der Pfad zum übergeordneten Verzeichnis. |
myfile |
Der Name der Datei. |
Informationen zu Pfadbenennungseinschränkungen finden Sie unter Namen- und Referenzfreigaben, Verzeichnisse, Dateien und Metadaten.
URI-Parameter
| Parameter | Beschreibung |
|---|---|
timeout |
Wahlfrei. Der parameter timeout wird in Sekunden ausgedrückt. Weitere Informationen finden Sie unter Festlegen von Timeouts für Azure Files-Vorgänge. |
Anforderungsheader
Die erforderlichen und optionalen Anforderungsheader werden in den folgenden Tabellen beschrieben:
Allgemeine Anforderungsheader
| Anforderungsheader | Beschreibung |
|---|---|
Authorization |
Erforderlich. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage. |
Date oder x-ms-date |
Erforderlich. Gibt die koordinierte Weltzeit (UTC) für die Anforderung an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage. |
x-ms-version |
Erforderlich für alle autorisierten Anforderungen. Gibt die Version des Vorgangs an, der für diese Anforderung verwendet werden soll. Dieser Vorgang wird in Version 2019-02-02 und höher für Dateifreigaben mit aktiviertem SMB-Protokoll unterstützt und in Version 2025-05-05 und höher für Dateifreigaben mit aktiviertem NFS-Protokoll unterstützt. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure Storage-Dienste. |
x-ms-copy-source:name |
Erforderlich. Gibt die URL der Quelldatei an. Der Wert kann eine URL von bis zu 2 KiB länge sein, die eine Datei angibt. Der Wert sollte URL-codiert sein, wie er in einem Anforderungs-URI angezeigt wird. Die Quelldatei muss entweder öffentlich sein oder über eine freigegebene Zugriffssignatur autorisiert werden. Wenn die Quelldatei öffentlich ist, ist keine Autorisierung erforderlich, um den Vorgang auszuführen. Hier sind einige Beispiele für Quellobjekt-URLs:
|
x-ms-copy-source-authorization: <scheme> <signature> |
Wahlfrei. Gibt das Autorisierungsschema und die Signatur für die Kopierquelle an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage. Nur der Schematräger wird für Microsoft Entra unterstützt. Dieser Header wird in Version 2020-10-02 und höher unterstützt. |
x-ms-write: { update } |
Erforderlich. Sie müssen nur updateangeben. Die Anforderung schlägt fehl, wenn sie mit clearaufgerufen wird. Der wert update schreibt die Byte, die vom Anforderungstext in die angegebenen Bereiche angegeben werden. |
Range oder x-ms-range |
Erforderlich. Es ist entweder Range oder x-ms-range erforderlich.Gibt den zu schreibenden Bytebereich an. Sowohl der Anfang als auch das Ende des Bereichs müssen angegeben werden. Dieser Header wird durch die HTTP/1.1-Protokollspezifikationdefiniert. Bei einem Aktualisierungsvorgang kann der Bereich bis zu 4 MiB groß sein. Azure Files akzeptiert nur einen einzelnen Bytebereich für die kopfzeilen Range und x-ms-range, und der Bytebereich muss im folgenden Format angegeben werden: bytes=startByte-endByte.Wenn sowohl Range als auch x-ms-range angegeben werden, verwendet der Dienst den Wert x-ms-range. Weitere Informationen finden Sie unter Angeben des Bereichsheaders für Azure Files-Vorgänge. |
x-ms-source-range |
Erforderlich. Gibt den Bytebereich an, der aus der Quelle gelesen werden soll. Sowohl der Anfang als auch das Ende des Bereichs müssen angegeben werden. Azure Files akzeptiert nur einen einzelnen Bytebereich für die kopfzeilen Range und x-ms-range, und der Bytebereich muss im folgenden Format angegeben werden: bytes=startByte-endByte.Der Quellbereich kann bis zu 4 MiB groß sein. Wenn die Größe des Quellbereichs 4 MiB überschreitet, gibt Azure Files den Statuscode 413 zurück (Anforderungsentität zu groß). Wenn die Größe des Quellbereichs nicht mit der Größe des Bereichs (Zielbereich) übereinstimmt, gibt der Dienst den Statuscode 400 (ungültige Anforderung) zurück. |
Content-Length |
Erforderlich. Gibt die Anzahl der Im Anforderungstext übertragenen Bytes an. Der Wert dieser Kopfzeile muss auf 0festgelegt werden. Wenn die Länge nicht 0ist, schlägt der Vorgang mit dem Statuscode 400 (Ungültige Anforderung) fehl. |
x-ms-client-request-id |
Wahlfrei. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem 1-Kibibyte-Zeichenlimit (KiB) bereit, der in den Protokollen aufgezeichnet wird, wenn die Protokollierung konfiguriert ist. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt. Weitere Informationen finden Sie unter Überwachen von Azure Files. |
x-ms-source-content-crc64 |
Wahlfrei. Ein CRC64-Hash des angegebenen Bereichs aus dem URI. Dieser Hash wird verwendet, um die Integrität des Bereichs während des Transports der Daten aus dem URI zu überprüfen. Wenn dieser Header angegeben ist, vergleicht Azure Files den Hash des Inhalts, der von der Kopiequelle mit diesem Headerwert eingegangen ist. Hinweis: Dieser CRC64-Hash wird nicht mit der Datei gespeichert. Wenn die beiden Hashes nicht übereinstimmen, schlägt der Vorgang mit dem Fehlercode 400 (Ungültige Anforderung) fehl. |
x-ms-source-if-match-crc64 |
Wahlfrei. Ein CRC64-Prüfsummenwert. Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn die Prüfsumme des angegebenen Bereichs aus Quellüberstimmungen aus der bereitgestellten Prüfsumme gelesen wird. Wenn die angegebene Bedingung nicht erfüllt ist, gibt Azure Files den Statuscode 412 zurück (Vorbedingung fehlgeschlagen). |
x-ms-source-if-none-match-crc64 |
Wahlfrei. Ein CRC64-Prüfsummenwert. Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn die Prüfsumme des angegebenen Bereichs, der von der Quelle gelesen wird, von der bereitgestellten Prüfsumme abweicht. Wenn die angegebene Bedingung nicht erfüllt ist, gibt Azure Files den Statuscode 412 zurück (Vorbedingung fehlgeschlagen). |
x-ms-lease-id: <ID> |
Erforderlich, wenn die Datei über eine aktive Lease verfügt. Verfügbar für Version 2019-02-02 und höher. Dieser Header wird ignoriert, wenn sich die Datei in einer Dateifreigabe mit aktiviertem NFS-Protokoll befindet, was Dateileases nicht unterstützt. |
x-ms-client-request-id |
Wahlfrei. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem 1-Kibibyte-Zeichenlimit (KiB) bereit, der in den Analyseprotokollen aufgezeichnet wird, wenn die Azure Storage Analytics-Protokollierung aktiviert ist. Es wird dringend empfohlen, diesen Header zu verwenden, wenn Sie clientseitige Aktivitäten mit Anforderungen korrelieren, die vom Server empfangen werden. Weitere Informationen finden Sie unter Monitor Blob Storage. |
x-ms-file-last-write-time: { now ¦ preserve } |
Wahlfrei. Version 2021-06-08 und höher. Sie können eine der folgenden Optionen angeben:
|
x-ms-file-request-intent |
Erforderlich, wenn Authorization Header ein OAuth-Token angibt. Zulässiger Wert ist backup. Dieser Header gibt an, dass die Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action oder Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action gewährt werden sollen, wenn sie in der RBAC-Richtlinie enthalten sind, die der Identität zugewiesen ist, die mithilfe des Authorization-Headers autorisiert ist. Verfügbar für Version 2022-11-02 und höher. |
x-ms-allow-trailing-dot: { <Boolean> } |
Wahlfrei. Version 2022-11-02 und höher. Der boolesche Wert gibt an, ob ein nachgestellter Punkt in der Anforderungs-URL gekürzt werden soll. Dieser Header wird ignoriert, wenn sich das Ziel auf einer Dateifreigabe mit aktiviertem NFS-Protokoll befindet, das den nachfolgenden Punkt standardmäßig unterstützt. Weitere Informationen finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Wahlfrei. Version 2022-11-02 und höher. Der boolesche Wert gibt an, ob ein nachgestellter Punkt in der Quell-URL gekürzt werden soll. Dieser Header sollte nur angegeben werden, wenn sich die Kopierquelle in einer Azure-Dateifreigabe befindet. Dieser Header wird für keinen anderen Kopierquelltyp unterstützt. Dieser Header wird ignoriert, wenn sich die Kopierquelle in einer Dateifreigabe mit aktiviertem NFS-Protokoll befindet, die den nachfolgenden Punkt standardmäßig unterstützt. Weitere Informationen finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten. |
Nur SMB-Anforderungsheader
Nichts.
NUR NFS-Anforderungsheader
Nichts.
Anforderungstext
Kein Anforderungstext.
Beispielanforderung
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
Antwort
Die Antwort enthält einen HTTP-Statuscode und eine Reihe von Antwortheadern.
Statuscode
Ein erfolgreicher Vorgang gibt den Statuscode 201 (Erstellt) zurück. Weitere Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.
Antwortheader
Die Antwort für diesen Vorgang enthält die Kopfzeilen in den folgenden Tabellen. Die Antwort kann auch zusätzliche Standard-HTTP-Header enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.
Allgemeine Antwortheader
| Antwortheader | Beschreibung |
|---|---|
ETag |
Enthält einen Wert, den Sie zum bedingten Ausführen von Vorgängen verwenden können. Der Wert wird in Anführungszeichen eingeschlossen. |
Last-Modified |
Datum und Uhrzeit der letzten Änderung der Datei. Das Datumsformat folgt RFC 1123. Weitere Informationen finden Sie unter Darstellung von Datums-/Uhrzeitwerten in Kopfzeilen. Jeder Schreibvorgang in der Datei, einschließlich Aktualisierungen der Metadaten oder Eigenschaften der Datei, ändert den Zeitpunkt der letzten Änderung der Datei. |
x-ms-request-id |
Identifiziert die anforderung eindeutig, die durchgeführt wurde, und Sie können sie verwenden, um die Anforderung zu beheben. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge. |
x-ms-version |
Gibt die FileREST-API-Version an, die zum Ausführen der Anforderung verwendet wurde. |
Date |
Ein UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der die Uhrzeit angibt, zu der die Antwort initiiert wurde. |
x-ms-content-crc64 |
Wird zurückgegeben, sodass der Client auf die Integrität von Nachrichteninhalten überprüfen kann. Der Wert dieses Headers wird von Azure Files berechnet. Er ist nicht notwendigerweise identisch mit dem Wert, der in den Anforderungsheadern angegeben ist. |
x-ms-client-request-id |
Kann verwendet werden, um Anfragen und entsprechende Antworten zu behandeln. Der Wert dieses Headers ist gleich dem Wert des x-ms-client-request-id Headers, wenn er in der Anforderung vorhanden ist und der Wert nicht mehr als 1.024 sichtbare ASCII-Zeichen enthält. Wenn der x-ms-client-request-id-Header in der Anforderung nicht vorhanden ist, ist er in der Antwort nicht vorhanden. |
x-ms-file-last-write-time |
Version 2021-06-08 und höher. Die letzte Schreibzeit für die Datei im ISO 8601-Format (z. B. 2017-05-10T17:52:33.9551861Z). |
Nur SMB-Antwortheader
Nichts.
NUR NFS-Antwortheader
Nichts.
Antworttext
Nichts.
Beispielantwort
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
Ermächtigung
Nur der Kontobesitzer kann diesen Vorgang aufrufen.
Bemerkungen
Der Put Range From URL-Vorgang schreibt einen Datenbereich in eine Datei und ähnelt dem Verhalten des Put Range Vorgangs. Er verwendet den vorgang Get File für die angegebene Quelle, um Daten, Metadaten und andere Eigenschaften der Quelldatei zu lesen. In Version 2020-10-02 und höher wird die Microsoft Entra-Autorisierung für die Quelle des Kopiervorgangs unterstützt.
Der Put Range From URL-Vorgang gibt Erfolg 201 (Erstellt) nur zurück, wenn der angegebene Bereich in die Datei geschrieben wird.