Přerušit kopírování souboru

Operace Abort Copy File zruší čekající operaci Copy File a ponechá cílový soubor s nulovou délkou a úplnými metadaty. Tato operace se podporuje ve verzi 2015-02-21 a novější pro sdílené složky s povoleným protokolem SMB a podporuje se ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS.

Dostupnost protokolu

Povolený protokol sdílené složky	K dispozici
SMB
NFS

Prosba

Požadavek Abort Copy File je vytvořen následujícím způsobem. Doporučujeme používat PROTOKOL HTTPS.

Od verze 2013-08-15 můžete pro cílový soubor zadat sdílený přístupový podpis, pokud je ve stejném účtu jako zdrojový soubor. Od verze 2015-04-05 můžete také zadat sdílený přístupový podpis pro cílový soubor, pokud je v jiném účtu úložiště.

Metoda	Identifikátor URI požadavku	Verze HTTP
DÁT	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=copy&copyid=<id>	HTTP/1.1

Součásti cesty zobrazené v identifikátoru URI požadavku nahraďte vlastními, a to následujícím způsobem:

Komponenta Path	Popis
myaccount	Název vašeho účtu úložiště.
myshare	Název sdílené složky.
mydirectorypath	Volitelný. Cesta k nadřazeného adresáři.
myfile	Název souboru.

Podrobnosti o omezeních pojmenování cest najdete v tématu Pojmenování a odkazování na sdílené složky, adresáře, soubory a metadata.

Parametry identifikátoru URI

Pro identifikátor URI požadavku můžete zadat následující další parametr.

Parametr	Popis
timeout	Volitelný. Parametr časového limitu se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace azure Files.

Hlavičky požadavku

Povinná a volitelná hlavička požadavku jsou popsána v následujících tabulkách:

Běžné hlavičky požadavků

Hlavička požadavku	Popis
Authorization	Požadovaný. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
Date nebo x-ms-date	Požadovaný. Určuje standard UTC (Coordinated Universal Time) pro požadavek. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
x-ms-version	Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Tato operace se podporuje ve verzi 2015-02-21 a novější pro sdílené složky s povoleným protokolem SMB a podporuje se ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-copy-action:abort	Požadovaný.
x-ms-lease-id:<ID>	Vyžaduje se, pokud má cílový soubor aktivní zapůjčení. K dispozici pro verze 2019-02-02 a novější. Tato hlavička se ignoruje, pokud se cílový soubor nachází ve sdílené složce s povoleným protokolem NFS, který nepodporuje zapůjčení souborů.
x-ms-client-request-id	Volitelný. Poskytuje hodnotu vygenerovanou klientem, neprůshlenou hodnotou s limitem znaků 1 kibibajtů (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování služby Azure Files.
x-ms-file-request-intent	Vyžaduje se, pokud hlavička Authorization určuje token OAuth. Přijatelná hodnota je backup. Tato hlavička určuje, že Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action by měly být uděleny, pokud jsou zahrnuty do zásad RBAC přiřazené k identitě, která je autorizovaná pomocí hlavičky Authorization. K dispozici pro verzi 2022-11-02 a novější.
x-ms-allow-trailing-dot: { <Boolean> }	Volitelný. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli by se měla oříznout koncová tečka v adrese URL požadavku, nebo ne. Tato hlavička se ignoruje, pokud se cíl nachází ve sdílené složce s povoleným protokolem NFS, který ve výchozím nastavení podporuje koncové tečky. Další informace najdete v tématu Pojmenování a odkazování na sdílené složky, adresáře, soubory a metadata.

Hlavičky požadavků jenom smb

Žádný.

Pouze hlavičky požadavků NFS

Žádný.

Text požadavku

Žádný.

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 204 (bez obsahu). Informace o stavových kódech naleznete v tématu Stav a kódy chyb.

Hlavičky odpovědi

Odpověď pro tuto operaci zahrnuje hlavičky v následujících tabulkách. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Běžná hlavička odpovědi

Hlavička odpovědi	Popis
x-ms-request-id	Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem.
x-ms-version	Označuje verzi služby Azure Files použitou ke spuštění požadavku.
Date nebo x-ms-date	Hodnota data a času UTC, která označuje čas, kdy byla odpověď zahájena. Služba vygeneruje tuto hodnotu.
x-ms-client-request-id	Tato hlavička slouží k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě hlavičky x-ms-client-request-id, pokud se nachází v požadavku. Hodnota je maximálně 1024 viditelných znaků ASCII. Pokud v požadavku není hlavička x-ms-client-request-id, nebude tato hlavička v odpovědi k dispozici.

Hlavičky odpovědi pouze smb

Žádný.

Pouze hlavičky odpovědi NFS

Žádný.

Text odpovědi

Žádný.

Oprávnění

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Při zrušení čekající operace Copy File je hlavička x-ms-copy-status cílového souboru nastavena na aborted. Zrušení operace kopírování způsobí, že cílový soubor má nulovou délku. Metadata cílového souboru ale budou obsahovat nové hodnoty zkopírované ze zdrojového objektu blob nebo souboru nebo explicitně nastavené ve volání operace Copy File.

Operaci kopírování, která čeká na vyřízení, můžete zrušit. Při pokusu o zrušení kopie, která se dokončila nebo selhala, dojde ke konfliktu. Při pokusu o zrušení operace kopírování pomocí nesprávného ID kopírování dojde také k chybě konfliktu.

Viz také

operace se soubory