Avbryt kopieringsfilen
Åtgärden Abort Copy File avbryter en väntande Copy File åtgärd och lämnar en målfil med noll längd och fullständiga metadata. Den här åtgärden stöds i version 2015-02-21 och senare för filresurser med SMB-protokollet aktiverat och stöds i version 2025-05-05 och senare för filresurser med NFS-protokollet aktiverat.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgänglig |
|---|---|
| SMB |
|
| NFS |
|
Begäran
Den Abort Copy File begäran skapas på följande sätt. Vi rekommenderar att du använder HTTPS.
Från och med version 2013-08-15 kan du ange en signatur för delad åtkomst för målfilen om den finns i samma konto som källfilen. Från och med version 2015-04-05 kan du också ange en signatur för delad åtkomst för målfilen om den finns i ett annat lagringskonto.
| Metod | Begärande-URI | HTTP-version |
|---|---|---|
| STÄLLA | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=copy©id=<id> |
HTTP/1.1 |
Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna enligt följande:
| Sökvägskomponent | Beskrivning |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
mydirectorypath |
Valfri. Sökvägen till den överordnade katalogen. |
myfile |
Namnet på filen. |
Mer information om namngivningsbegränsningar för sökvägar finns i Namngivnings- och referensresurser, kataloger, filer och metadata.
URI-parametrar
Du kan ange följande ytterligare parameter på begärande-URI:n.
| Parameter | Beskrivning |
|---|---|
timeout |
Valfri. Tidsgränsparametern uttrycks i sekunder. Mer information finns i Ange tidsgränser för Azure Files-åtgärder. |
Begärandehuvuden
De obligatoriska och valfria begäranderubrikerna beskrivs i följande tabeller:
Vanliga begärandehuvuden
| Begärandehuvud | Beskrivning |
|---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date eller x-ms-date |
Krävs. Anger UTC (Coordinated Universal Time) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Den här åtgärden stöds i version 2015-02-21 och senare för filresurser med SMB-protokollet aktiverat och stöds i version 2025-05-05 och senare för filresurser med NFS-protokollet aktiverat. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-copy-action:abort |
Krävs. |
x-ms-lease-id:<ID> |
Krävs om målfilen har ett aktivt lån. Tillgänglig för versionerna 2019-02-02 och senare. Det här huvudet ignoreras om målfilen finns på en filresurs med NFS-protokollet aktiverat, vilket inte stöder fillån. |
x-ms-client-request-id |
Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB) som registreras i loggarna när loggningen konfigureras. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Files-. |
x-ms-file-request-intent |
Krävs om Authorization rubrik anger en OAuth-token. Acceptabelt värde är backup. Det här huvudet anger att Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action eller Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action ska beviljas om de ingår i RBAC-principen som tilldelats den identitet som är auktoriserad med hjälp av Authorization-huvudet. Tillgänglig för version 2022-11-02 och senare. |
x-ms-allow-trailing-dot: { <Boolean> } |
Valfri. Version 2022-11-02 och senare. Det booleska värdet anger om en avslutande punkt som finns i begärande-URL:en ska trimmas eller inte. Det här huvudet ignoreras om målet finns på en filresurs med NFS-protokollet aktiverat, vilket stöder avslutande punkt som standard. Mer information finns i Namngivning och referens av resurser, kataloger, filer och metadata. |
Endast SMB-begärandehuvuden
Ingen.
Endast NFS-begärandehuvuden
Ingen.
Begärandetext
Ingen.
Svar
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskoden 204 (inget innehåll). Information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller rubrikerna i följande tabeller. Svaret kan också innehålla ytterligare standard-HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
Vanliga svarshuvuden
| Svarsrubrik | Beskrivning |
|---|---|
x-ms-request-id |
Det här huvudet identifierar unikt den begäran som gjordes och kan användas för att felsöka begäran. |
x-ms-version |
Anger vilken version av Azure Files som används för att köra begäran. |
Date eller x-ms-date |
Ett UTC-datum/tid-värde som anger den tid då svaret initierades. Tjänsten genererar det här värdet. |
x-ms-client-request-id |
Du kan använda den här rubriken för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id-huvudet, om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken. Om x-ms-client-request-id-huvudet inte finns i begäran visas inte det här huvudet i svaret. |
Endast SMB-svarshuvuden
Ingen.
Endast NFS-svarshuvuden
Ingen.
Svarstext
Ingen.
Tillstånd
Endast kontoägaren kan anropa den här åtgärden.
Anmärkningar
När du avbryter en väntande Copy File åtgärd är målfilens x-ms-copy-status huvud inställt på aborted. Om du avbryter en kopieringsåtgärd resulterar det i en målfil med noll längd. Metadata för målfilen kommer dock att ha de nya värdena kopierade från källbloben eller -filen, eller anges uttryckligen i Copy File åtgärdsanropet.
Du kan bara avbryta en kopieringsåtgärd som väntar. Ett försök att avbryta en kopia som har slutförts eller misslyckats resulterar i konfliktfel. Försök att avbryta en kopieringsåtgärd med hjälp av ett felaktigt kopierings-ID resulterar också i konfliktfel.