Datei kopieren

Der vorgang Copy File kopiert ein BLOB oder eine Datei in eine Zieldatei innerhalb des Speicherkontos. Dieser Vorgang wird in Version 2015-02-21 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 Copy File Anforderung wird wie folgt erstellt. Es wird empfohlen, HTTPS zu verwenden.

Ab Version 2013-08-15 können Sie eine Freigegebene Zugriffssignatur für die Zieldatei angeben, wenn sie sich im selben Konto wie die Quelldatei befindet. Ab Version 2015-04-05 können Sie auch eine Freigegebene Zugriffssignatur für die Zieldatei angeben, wenn sie sich in einem anderen Speicherkonto befindet.

Ersetzen Sie die pfadkomponenten, die im Anforderungs-URI angezeigt werden, wie folgt:

Ausführliche Informationen zu Pfadbenennungseinschränkungen finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten.

URI-Parameter

Sie können die folgenden zusätzlichen Parameter für den Anforderungs-URI angeben:

Anforderungsheader

Die erforderlichen und optionalen Anforderungsheader werden in den folgenden Tabellen beschrieben:

Allgemeine Anforderungsheader

Nur SMB-Anforderungsheader

NUR NFS-Anforderungsheader

Anforderungstext

Nichts.

Antwort

Die Antwort enthält einen HTTP-Statuscode und eine Reihe von Antwortheadern.

Statuscode

Ein erfolgreicher Vorgang gibt den Statuscode 202 (Akzeptiert) zurück. 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

Nur SMB-Antwortheader

Nichts.

NUR NFS-Antwortheader

Nichts.

Antworttext

Nichts

Beispielantwort

Response Status:  
HTTP/1.1 202 Accepted  
  
Response Headers:   
Last-Modified: <date>   
ETag: "0x8CEB669D794AFE2"  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402  
x-ms-version: 2015-02-21  
x-ms-copy-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
x-ms-copy-status: pending  
Date: <date>  

Ermächtigung

Dieser Vorgang kann vom Kontobesitzer oder von einem Client mit einer freigegebenen Zugriffssignatur aufgerufen werden, die über die Berechtigung zum Schreiben in die Zieldatei oder deren Freigabe verfügt. Beachten Sie, dass die in der Anforderung angegebene Signatur für den freigegebenen Zugriff nur für die Zieldatei gilt.

Der Zugriff auf die Quelldatei oder das BLOB wird separat autorisiert, wie in den Details für den Anforderungsheader x-ms-copy-sourcebeschrieben.

In der folgenden Tabelle wird beschrieben, wie die Ziel- und Quellobjekte für einen Copy File Vorgang autorisiert werden können:

Dateisystemattribute

POSIX-Dateiberechtigungen (Modus)

POSIX-Dateiberechtigungen können numerisch in einem 12-Bit-Numerischen Oktalformat oder in einem symbolischen "rwx"-Format angegeben werden. Beispiele:

• "0644" oder "rw-r-r---": Der Benutzer (Dateibesitzer) verfügt über Lese-, Schreibberechtigungen. Gruppe verfügt über Leseberechtigungen. Andere Personen verfügen über Leseberechtigungen.
• "0755" oder "rwxr-xr-x": Der Benutzer (Dateibesitzer) verfügt über Lese-, Schreib- und Ausführungsberechtigungen. Die Gruppe verfügt über Lese- und Ausführungsberechtigungen. Andere Haben Lese- und Ausführungsberechtigungen.

Numerisches oktales Format

Die drei niedrigsten oktalen Zahlen der Reihenfolge stellen die Berechtigungen für Besitzer/Benutzer, Gruppe und andere dar und werden mit einer oktalen Zahl (0-7) angegeben, die mit einer bitweisen Kombination von "4" (Lesen), "2" (Schreiben), "1" (Ausführen) gebildet wird. Die höchste Oktale Zahl (0-7) wird verwendet, um eine Kombination von '4' (SetUID), '2' (SetGID), '1' (StickyBit)-Berechtigungen anzugeben.

Symbolisches "rwx"-Format

Berechtigungen für Besitzer/Benutzer, Gruppen und andere werden mithilfe einer Kombination von Zeichen "r" (Lesen), "w" (Schreiben) und "x" (Execute) angegeben.

Bemerkungen

Der Copy File-Vorgang kann asynchron abgeschlossen werden. Sie können die Kopier-ID verwenden, die der x-ms-copy-id Antwortheader zurückgibt, um den Status des Kopiervorgangs zu überprüfen oder abzubrechen. Azure Files kopiert Dateien auf best-effort-Basis.

Wenn die Zieldatei vorhanden ist, wird sie überschrieben. Sie können die Zieldatei nicht ändern, während der Kopiervorgang ausgeführt wird.

Der vorgang Copy File kopiert immer das gesamte Quell-BLOB oder die gesamte Datei. Das Kopieren eines Bytebereichs oder einer Gruppe von Blöcken wird nicht unterstützt.

Die Quelle eines Copy File Vorgangs kann eine Datei sein, die sich in einer Freigabemomentaufnahme befindet. Das Ziel eines Copy File Vorgangs kann keine Datei sein, die sich in einer Freigabemomentaufnahme befindet.

Wenn die Quelle eines Kopiervorgangs ETag Werte bereitstellt, tritt ein Fehler auf, wenn änderungen an der Quelle vorgenommen werden, während der Vorgang ausgeführt wird. Ein Versuch, die Zieldatei zu ändern, während ein Kopiervorgang ausgeführt wird, schlägt mit dem Statuscode 409 (Konflikt) fehl.

Der ETag Wert für die Zieldatei ändert sich, wenn der Copy File Vorgang gestartet wird. Es ändert sich während des Kopiervorgangs weiterhin häufig.

Kopieren von Eigenschaften und Metadaten

Wenn ein Blob oder eine Datei kopiert wird, werden die folgenden Systemeigenschaften mit denselben Werten in die Zieldatei kopiert:

• Content-Type
• Content-Encoding
• Content-Language
• Content-Length
• Cache-Control
• Content-MD5
• Content-Disposition

Die Zieldatei ist immer dieselbe Größe wie das Quell-BLOB oder die Quelldatei. Der Wert des Content-Length-Headers für die Zieldatei entspricht dem Wert dieses Headers für das Quell-BLOB oder die Quelldatei.

Kopieren eines leaseten Blobs oder einer Datei in eine Datei

Der Copy File Vorgang liest nur aus dem Quell-BLOB oder der Quelldatei, sodass eine Lease für das Quellobjekt den Vorgang nicht beeinflusst. Der Copy File Vorgang speichert den ETag Wert des Quell-Blobs oder der Datei, wenn der Vorgang gestartet wird. Wenn sich der ETag Wert ändert, bevor der Kopiervorgang abgeschlossen ist, schlägt der Vorgang fehl. Sie können Änderungen am Quell-BLOB der Datei verhindern, indem Sie sie während des Kopiervorgangs leasingen.

Wenn die Zieldatei über eine aktive unendliche Lease verfügt, müssen Sie die Lease-ID im Aufruf des Copy File-Vorgangs angeben. Während der Kopiervorgang aussteht, schlägt jeder Leasevorgang in der Zieldatei mit dem Statuscode 409 (Konflikt) fehl. Eine unendliche Lease für die Zieldatei wird während des Kopiervorgangs auf diese Weise gesperrt, unabhängig davon, ob Sie in eine Zieldatei kopieren, die einen anderen Namen als die Quelle hat oder in eine Zieldatei kopiert wird, die denselben Namen wie die Quelle hat. Wenn der Client eine Lease-ID für eine Datei angibt, die noch nicht vorhanden ist, gibt Azure Files den Statuscode 412 zurück (Vorbedingung fehlgeschlagen).

Arbeiten mit einem ausstehenden Kopiervorgang

Der vorgang Copy File kann das asynchrone Kopieren der Dateien beenden. Verwenden Sie die folgende Tabelle, um den nächsten Schritt basierend auf dem Statuscode zu bestimmen, der zurückgegeben Copy File:

Während und nach einem Copy File Vorgang enthalten die Eigenschaften der Zieldatei die Kopier-ID des Copy File Vorgangs und die URL des Quell-Blobs oder der Datei. Nach Abschluss des Vorgangs schreibt Azure Files den Zeit- und Ergebniswert (success, failedoder aborted) in die Eigenschaften der Zieldatei. Wenn der Vorgang ein failed Ergebnis hat, enthält der x-ms-copy-status-description Header eine Fehlerdetailseite.

Ein ausstehender Copy File Vorgang hat ein zweiwöchiges Timeout. Ein Kopierversuch, der nach zwei Wochen nicht beendet wurde, und hinterlässt eine leere Datei, wobei das feld x-ms-copy-status auf failed festgelegt ist, und das feld x-ms-status-description auf 500 (OperationCancelled) festgelegt ist. Zeitweilige, nicht schwerwiegende Fehler, die während eines Kopiervorgangs auftreten können, beeinträchtigen den Fortschritt des Vorgangs, verursachen jedoch keinen Fehler. In diesen Fällen beschreibt x-ms-copy-status-description die zeitweiligen Fehler.

Jeder Versuch, die Zieldatei während des Kopiervorgangs zu ändern, schlägt mit dem Statuscode 409 (Konflikt), "Datei in Bearbeitung kopieren" fehl.

Wenn Sie einen Abort Copy File Vorgang aufrufen, wird ein x-ms-copy-status:aborted Header angezeigt. Die Zieldatei hat intakte Metadaten und eine Dateilänge von 0 Byte. Sie können den ursprünglichen Aufruf an Copy File wiederholen, um den Vorgang erneut auszuführen.

Abrechnung

Das Zielkonto eines Copy File Vorgangs wird für eine Transaktion berechnet, um den Vorgang zu starten. Das Zielkonto verursacht für jede Anforderung auch eine Transaktion, um den Status des Kopiervorgangs abzubrechen oder anzufordern.

Wenn sich die Quelldatei oder der Blob in einem anderen Konto befindet, verursacht das Quellkonto Transaktionskosten. Wenn sich die Quell- und Zielkonten in verschiedenen Regionen (z. B. "USA Nord" und "US Süd") befinden, wird die Bandbreite, die Sie zum Übertragen der Anforderung verwenden, als Ausgang auf das Quellkonto belastet. Der Ausgang zwischen Konten innerhalb derselben Region ist kostenlos.

Siehe auch

• Vorgänge für Dateien
• Autorisieren von Anforderungen an Azure Storage
• Status- und Fehlercodes
• Azure Files-Fehlercodes
• Datei abbrechen