Freigeben über

Abbrechen des Kopierens der Datei

Der Abort Copy File Vorgang bricht einen ausstehenden Copy File Vorgang ab und belässt eine Zieldatei mit null Länge und vollständigen Metadaten. 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 Ja
NFS Ja

Bitten

Die Abort 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.

Methode Anforderungs-URI HTTP-Version
STELLEN https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=copy&copyid=<id> 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.

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

URI-Parameter

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

Parameter Beschreibung
timeout Wahlfrei. Der Timeoutparameter 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 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.

Weitere Informationen finden Sie unter Versionsverwaltung für die Azure Storage-Dienste.
x-ms-copy-action:abort Erforderlich.
x-ms-lease-id:<ID> Erforderlich, wenn die Zieldatei über eine aktive Lease verfügt. Verfügbar für Versionen 2019-02-02 und höher.

Dieser Header wird ignoriert, wenn sich die Zieldatei in einer Dateifreigabe mit aktiviertem NFS-Protokoll befindet, die Dateileasings 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 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-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.

Nur SMB-Anforderungsheader

Nichts.

NUR NFS-Anforderungsheader

Nichts.

Anforderungstext

Nichts.

Antwort

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

Statuscode

Ein erfolgreicher Vorgang gibt den Statuscode 204 (Kein Inhalt) 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

Antwortheader Beschreibung
x-ms-request-id Dieser Header identifiziert die anforderung eindeutig und kann für die Problembehandlung der Anforderung verwendet werden.
x-ms-version Gibt die Version von Azure Files an, die zum Ausführen der Anforderung verwendet wird.
Date oder x-ms-date Ein UTC-Datums-/Uhrzeitwert, der die Uhrzeit angibt, zu der die Antwort initiiert wurde. Der Dienst generiert diesen Wert.
x-ms-client-request-id Sie können diesen Header verwenden, 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. Der Wert beträgt höchstens 1024 sichtbare ASCII-Zeichen. Wenn der x-ms-client-request-id-Header in der Anforderung nicht vorhanden ist, ist dieser Header in der Antwort nicht vorhanden.

Nur SMB-Antwortheader

Nichts.

NUR NFS-Antwortheader

Nichts.

Antworttext

Nichts.

Ermächtigung

Nur der Kontobesitzer kann diesen Vorgang aufrufen.

Bemerkungen

Wenn Sie einen ausstehenden Copy File Vorgang abbrechen, wird die x-ms-copy-status Kopfzeile der Zieldatei auf abortedfestgelegt. Das Abbrechen eines Kopiervorgangs führt zu einer Zieldatei mit null Länge. Die Metadaten für die Zieldatei haben jedoch die neuen Werte aus dem Quell-BLOB oder der Quelldatei kopiert oder explizit im Copy File Vorgangsaufruf festgelegt.

Sie können nur einen ausstehenden Kopiervorgang abbrechen. Wenn Sie versuchen, eine Kopie abzubrechen, die abgeschlossen wurde oder fehlgeschlagen ist, tritt ein Konfliktfehler auf. Wenn Sie versuchen, einen Kopiervorgang mit einer falschen Kopier-ID abzubrechen, tritt auch ein Konfliktfehler auf.

Siehe auch

Vorgänge für Dateien

  • Last updated on