Kopírovat soubor
Operace Copy File zkopíruje objekt blob nebo soubor do cílového souboru v rámci účtu úložiš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.
Dostupnost protokolu
| Povolený protokol sdílené složky | K dispozici |
|---|---|
| SMB |
|
| NFS |
|
Prosba
Požadavek 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 |
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ší parametry:
| Parametr | Popis |
|---|---|
timeout |
Volitelný. Parametr timeout 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-meta-name:value |
Volitelný. Určuje páry název/hodnota přidružené k souboru jako metadata. Pokud nejsou zadány žádné dvojice název/hodnota, operace zkopíruje metadata ze zdrojového objektu blob nebo souboru do cílového souboru. Pokud je zadaný jeden nebo více párů název/hodnota, vytvoří se cílový soubor se zadanými metadaty a metadata se nezkopírují ze zdrojového objektu blob nebo souboru. Názvy metadat musí dodržovat pravidla pojmenování pro identifikátory jazyka C# . Metadata souborů zadaná prostřednictvím služby Azure Files nejsou přístupná z klienta SMB. |
x-ms-copy-source:name |
Požadovaný. Určuje adresu URL zdrojového souboru nebo objektu blob o délce až 2 kibibajtů (KiB). Pokud chcete zkopírovat soubor do jiného souboru ve stejném účtu úložiště, můžete k autorizaci zdrojového souboru použít sdílený klíč. Pokud kopírujete soubor z jiného účtu úložiště nebo pokud kopírujete objekt blob ze stejného účtu úložiště nebo jiného účtu úložiště, musíte zdrojový soubor nebo objekt blob autorizovat pomocí sdíleného přístupového podpisu. Pokud je zdrojem veřejný objekt blob, k provedení operace kopírování se nevyžaduje žádná autorizace. Jako zdroj kopírování můžete také zadat soubor ve snímku sdílené složky. Tady je několik příkladů adres URL zdrojového objektu:
|
x-ms-lease-id:<ID> |
Vyžaduje se, pokud má cílový soubor aktivní zapůjčení. K dispozici pro verzi 2019-02-02 a novější. ID zapůjčení zadané pro tuto hlavičku musí odpovídat ID zapůjčení cílového souboru. Pokud požadavek neobsahuje ID zapůjčení nebo ID není platné, operace selže se stavovým kódem 412 (předběžná podmínka se nezdařila). Pokud je tato hlavička zadaná a cílový soubor aktuálně nemá aktivní zapůjčení, operace selže se stavovým kódem 412 (předběžná podmínka se nezdařila). 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-file-creation-time |
Volitelný. K dispozici pro verzi 2019-07-07 a novější. Tato hlavička určuje vlastnost pro čas vytvoření v UTC, která se má nastavit v cílovém souboru. Hodnotu source můžete použít ke zkopírování času vytvoření ze zdrojového souboru do cílového souboru. |
x-ms-file-last-write-time |
Volitelný. K dispozici pro verzi 2019-07-07 a novější. Tato hlavička určuje vlastnost pro čas posledního zápisu v UTC, která se má nastavit v cílovém souboru. Hodnotu source můžete použít ke zkopírování posledního času zápisu ze zdrojového souboru do cílového souboru. |
x-ms-client-request-id |
Volitelný. Poskytuje hodnotu vygenerovanou klientem s neprůhlenou hodnotou s limitem znaků 1 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 Blob Storage. |
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 se mají udělit Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action, 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. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Volitelný. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli má být koncové tečky ve zdrojové adrese URL oříznuté nebo ne. Tato hlavička by se měla zadat jenom v případě, že zdroj kopírování je umístěný ve sdílené složce Azure. Tato hlavička není podporovaná pro žádný jiný typ zdroje kopírování. Tato hlavička se ignoruje, pokud je zdroj kopírování umístěný 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
| Hlavička požadavku | Popis |
|---|---|
x-ms-file-change-time: { <DateTime> ¦ source } |
Volitelný. Verze 2021-06-08 a novější Vlastnost času změny UTC pro soubor formátovaná ve formátu ISO 8601. Hodnotu source lze použít ke zkopírování času změny ze zdrojového souboru do cílového souboru. Výchozí časové razítko je čas požadavku. |
x-ms-file-permission-copy-mode: { source ¦ override } |
Volitelný. K dispozici pro verzi 2019-07-07 a novější. Určuje chování kopírování popisovače zabezpečení souboru:
|
x-ms-file-permission: { <SDDL> ¦ <binary> } |
Vyžaduje se, pokud je x-ms-file-permission-copy-mode zadán jako override a x-ms-file-permission-key není zadán. K dispozici pro verzi 2019-07-07 a novější. Toto oprávnění je popisovač zabezpečení pro soubor zadaný v SDDL (Security Descriptor Definition Language) nebo (verze 2025-01-01-05 nebo novější) ve formátu binární popisovač zabezpečení. Můžete určit, který formát se má použít se záhlavím x-ms-file-permission-format. Tuto hlavičku můžete použít, pokud je velikost oprávnění 8 kibibajtů (KiB) nebo menší. V opačném případě můžete použít x-ms-file-permission-key. Pokud je uvedeno, musí mít vlastníka, skupinu a volitelný seznam řízení přístupu (DACL). Lze zadat pouze jeden z x-ms-file-permission nebo x-ms-file-permission-key. |
x-ms-file-permission-key |
Vyžaduje se, pokud je x-ms-file-permission-copy-mode zadán jako override a x-ms-file-permission není zadán. K dispozici pro verzi 2019-07-07 a novější. Tato hlavička určuje klíč oprávnění, které se má pro soubor nastavit. Tento klíč můžete vytvořit pomocí operace Create Permission.Lze zadat pouze jeden z x-ms-file-permission nebo x-ms-file-permission-key. |
x-ms-file-permission-format: { sddl ¦ binary } |
Volitelný. Verze 2025-01-05 nebo novější Určuje, zda hodnota předaná v x-ms-file-permission je v SDDL nebo v binárním formátu. Pokud tato hlavička není nastavená, použije se výchozí hodnota sddl. |
x-ms-file-attributes |
Volitelný. K dispozici pro verzi 2019-07-07 a novější. Tato hlavička určuje atributy systému souborů, které se mají nastavit v cílovém souboru. Prohlédněte si seznam dostupných atributů. Pomocí hodnoty source můžete zkopírovat atributy ze zdrojového souboru do cílového souboru. Hodnotu none můžete použít k vymazání všech atributů v cílovém souboru. |
x-ms-file-copy-ignore-readonly |
Volitelný. K dispozici pro verzi 2019-07-07 a novější. Tato logická hodnota určuje, zda má být dodržen atribut ReadOnly u existujícího cílového souboru. Pokud je true, operace kopírování proběhne úspěšně. Jinak předchozí soubor v cíli se sadou atributů ReadOnly způsobí selhání operace kopírování. |
x-ms-file-copy-set-archive |
Volitelný. K dispozici pro verzi 2019-07-07 a novější. Tato logická hodnota určuje, zda má být nastaven atribut Archive bez ohledu na hodnotu hlavičky x-ms-file-attributes. |
Pouze hlavičky požadavků NFS
| Hlavička požadavku | Popis |
|---|---|
x-ms-file-mode-copy-mode: { source ¦ override } |
Volitelný. Verze 2025-05-05 a novější. Platí pouze v případě, že zdrojem kopírování je soubor umístěný ve sdílené složce s povoleným protokolem NFS. Určuje chování kopírování bitů režimu souboru:
|
x-ms-mode |
Verze 2025-05-05 a novější. Vyžaduje se, pokud je x-ms-file-mode-copy-mode zadána jako override. Bity režimu, které se mají nastavit v souboru. Režim je reprezentován ve 12bitovém osmičkovém formátu nebo symbolickém formátu rwx. Viz oprávnění k souborům POSIX (režim). |
x-ms-file-owner-copy-mode: { source ¦ override } |
Volitelný. Verze 2025-05-05 a novější. Platí pouze v případě, že zdrojem kopírování je soubor umístěný ve sdílené složce s povoleným protokolem NFS. Určuje chování kopírování identifikátoru uživatele vlastníka (UID) a identifikátoru skupiny (GID) souboru:
|
x-ms-owner |
Verze 2025-05-05 a novější. Identifikátor uživatele (UID) vlastníka souboru, který se má v souboru nastavit. Vyžaduje se, pokud je x-ms-file-owner-copy-mode zadána jako override. |
x-ms-group |
Verze 2025-05-05 a novější. Identifikátor skupiny (GID) vlastníka souboru, který se má v souboru nastavit. Vyžaduje se, pokud je x-ms-file-owner-copy-mode zadána jako override. |
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 202 (přijato). 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 |
|---|---|
ETag |
Pokud je operace kopírování dokončena, obsahuje ETag hodnotu cílového souboru. Pokud operace kopírování není dokončená, obsahuje ETag hodnotu prázdného souboru vytvořeného na začátku operace. |
Last-Modified |
Vrátí datum a čas, kdy se operace kopírování do cílového souboru dokončila. |
x-ms-request-id |
Jednoznačně identifikuje požadavek, který byl proveden. Tuto hlavičku můžete použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API. |
x-ms-version |
Označuje verzi služby Azure Files, která se používá k provedení požadavku. |
Date |
Hodnota data a času UTC, která označuje čas, kdy služba odeslala odpověď. |
x-ms-copy-id: <id> |
Poskytuje identifikátor řetězce pro tuto operaci kopírování. Pomocí Get File nebo Get File Properties můžete zkontrolovat stav této operace kopírování nebo předat Abort Copy File zrušit čekající operaci kopírování. |
x-ms-copy-status: <success ¦ pending> |
Určuje stav operace kopírování s těmito hodnotami: - success: Operace kopírování byla úspěšně dokončena.- pending: Operace kopírování stále probíhá. |
x-ms-client-request-id |
Dá se použít 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 a hodnota je maximálně 1 024 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ý
Ukázková odpověď
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>
Oprávnění
Tuto operaci může volat vlastník účtu nebo klient se sdíleným přístupovým podpisem, který má oprávnění k zápisu do cílového souboru nebo jeho sdílené složky. Všimněte si, že sdílený přístupový podpis zadaný v požadavku se vztahuje pouze na cílový soubor.
Přístup ke zdrojovému souboru nebo objektu blob je autorizovaný samostatně, jak je popsáno v podrobnostech hlavičky požadavku x-ms-copy-source.
Následující tabulka popisuje, jak lze autorizovat cílové a zdrojové objekty pro operaci Copy File:
| Soubor | Autorizace pomocí sdíleného klíče nebo sdíleného klíče Lite | Autorizace se sdíleným přístupovým podpisem | Veřejný objekt nevyžaduje autorizaci |
|---|---|---|---|
| Cílový soubor | Ano | Ano | Nejde použít |
| Zdrojový soubor ve stejném účtu | Ano | Ano | Nejde použít |
| Zdrojový soubor v jiném účtu | Ne | Ano | Nejde použít |
| Zdrojový objekt blob ve stejném účtu nebo jiném účtu | Ne | Ano | Ano |
Atributy systému souborů
| Atribut | Atribut souboru Win32 | Definice |
|---|---|---|
ReadOnly |
FILE_ATTRIBUTE_READONLY |
Soubor je jen pro čtení. Aplikace můžou soubor číst, ale nemůžou do něj zapisovat ani je odstraňovat. |
Hidden |
FILE_ATTRIBUTE_HIDDEN |
Soubor je skrytý. Není součástí běžného seznamu adresářů. |
System |
FILE_ATTRIBUTE_SYSTEM |
Operační systém používá část souboru nebo používá soubor výhradně. |
None |
FILE_ATTRIBUTE_NORMAL |
Soubor nemá nastavené další atributy. Tento atribut je platný pouze v případě, že se používá samostatně. |
Archive |
FILE_ATTRIBUTE_ARCHIVE |
Soubor je archivní soubor. Aplikace obvykle tento atribut používají k označení souborů pro zálohování nebo odebrání. |
Temporary |
FILE_ATTRIBUTE_TEMPORARY |
Soubor se používá pro dočasné úložiště. |
Offline |
FILE_ATTRIBUTE_OFFLINE |
Data souboru nejsou k dispozici okamžitě. Tento atribut systému souborů poskytuje především kompatibilitu s Windows. Služba Azure Files ji nepodporuje s možnostmi offline úložiště. |
NotContentIndexed |
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED |
Služba indexování obsahu soubor neindexuje. |
NoScrubData |
FILE_ATTRIBUTE_NO_SCRUB_DATA |
Skener integrity dat na pozadí nepřečte datový proud uživatelů. Tento atribut systému souborů poskytuje především kompatibilitu s Windows. |
Oprávnění k souborům POSIX (režim)
Oprávnění k souborům POSIX je možné zadat číselně v osmičkovém formátu 12bitového formátu nebo v symbolickém formátu rwx. Příklady:
- "0644" nebo "rw-r--r--": Uživatel (vlastník souboru) má oprávnění ke čtení a zápisu. Skupina má oprávnění ke čtení. Ostatní mají oprávnění ke čtení.
- 0755 nebo rwxr-xr-x: Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění. Skupina má oprávnění ke čtení a spuštění. Ostatní mají oprávnění ke čtení a spouštění.
Číselný osmičkový formát
Tři osmičková čísla nejnižšího pořadí představují oprávnění pro vlastníka/uživatele, skupinu a další a označují se pomocí osmičkového čísla (0–7), která se vytvoří pomocí bitové kombinace 4 (čtení), 2 (zápis), 1 (Spustit). Osmičkové číslo nejvyššího pořadí (0–7) se používá k označení kombinace oprávnění 4 (SetUID), 2 (SetGID), 1 (StickyBit).
| Formát | Povolení |
|---|---|
| 0700 | Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění. |
| 0400 | Uživatel má oprávnění ke čtení. |
| 0200 | Uživatel má oprávnění k zápisu. |
| 0100 | Uživatel má oprávnění ke spuštění. |
| 0070 | Skupina má oprávnění ke čtení, zápisu a spuštění. |
| 0040 | Skupina má oprávnění ke čtení. |
| 0020 | Skupina má oprávnění k zápisu. |
| 0010 | Skupina má oprávnění ke spuštění. |
| 0007 | Ostatní mají oprávnění ke čtení, zápisu a spouštění. |
| 0004 | Ostatní mají oprávnění ke čtení. |
| 0002 | Ostatní mají oprávnění k zápisu. |
| 0001 | Ostatní mají oprávnění ke spuštění. |
| 4000 | Nastavte efektivní ID uživatele v souboru. |
| 2000 | Nastavte pro soubor efektivní ID skupiny. |
| 1000 | Nastaví se na označení, že soubor lze odstranit nebo přejmenovat pouze vlastníkem souboru, vlastníkem adresáře nebo uživatelem root. |
Symbolický formát rwx
Oprávnění pro vlastníka/uživatele, skupinu a další uživatele jsou označená pomocí kombinace znaků r (Read), w (Write) a x (Execute).
| Formát | Povolení |
|---|---|
| rwx------ | Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění. |
| r-------- | Uživatel má oprávnění ke čtení. |
| -w------- | Uživatel má oprávnění k zápisu. |
| --x------ | Uživatel má oprávnění ke spuštění. |
| ---rwx--- | Skupina má oprávnění ke čtení, zápisu a spuštění. |
| ---r----- | Skupina má oprávnění ke čtení. |
| ----w---- | Skupina má oprávnění k zápisu. |
| -----x--- | Skupina má oprávnění ke spuštění. |
| ------rwx | Ostatní mají oprávnění ke čtení, zápisu a spouštění. |
| ------r-- | Ostatní mají oprávnění ke čtení. |
| -------w- | Ostatní mají oprávnění k zápisu. |
| --------x | Ostatní mají oprávnění ke spuštění. |
Poznámky
Operace Copy File může dokončit asynchronně. Pomocí ID kopírování, které se vrátí hlavička x-ms-copy-id odpovědi, můžete zkontrolovat stav operace kopírování nebo ji zrušit. Služba Azure Files kopíruje soubory na základě maximálního úsilí.
Pokud cílový soubor existuje, přepíše se. Během probíhající operace kopírování nelze cílový soubor upravit.
Operace Copy File vždy kopíruje celý zdrojový objekt blob nebo soubor. Kopírování rozsahu bajtů nebo sady bloků se nepodporuje.
Zdrojem operace Copy File může být soubor, který se nachází ve snímku sdílené složky. Cílem operace Copy File nemůže být soubor, který se nachází ve snímku sdílené složky.
Pokud zdroj operace kopírování poskytuje ETag hodnoty, pokud během probíhající operace dojde ke změnám zdroje, selže. Pokus o změnu cílového souboru v době, kdy probíhá operace kopírování, selže se stavovým kódem 409 (konflikt).
Hodnota ETag cílového souboru se změní při spuštění operace Copy File. Během operace kopírování se i nadále často mění.
Kopírování vlastností a metadat
Při zkopírování objektu blob nebo souboru se do cílového souboru zkopírují následující systémové vlastnosti se stejnými hodnotami:
Content-TypeContent-EncodingContent-LanguageContent-LengthCache-ControlContent-MD5Content-Disposition
Cílový soubor má vždy stejnou velikost jako zdrojový objekt blob nebo soubor. Hodnota hlavičky Content-Length cílového souboru odpovídá hodnotě této hlavičky pro zdrojový objekt blob nebo soubor.
Kopírování zapůjčeného objektu blob nebo souboru do souboru
Operace Copy File čte pouze ze zdrojového objektu blob nebo souboru, takže zapůjčení zdrojového objektu nemá vliv na operaci. Operace Copy File uloží ETag hodnotu zdrojového objektu blob nebo souboru při spuštění operace. Pokud se hodnota ETag před dokončením operace kopírování změní, operace selže. Změny zdrojového objektu blob souboru můžete zabránit tím, že ho pronajímáte během operace kopírování.
Pokud má cílový soubor aktivní nekonečné zapůjčení, musíte v volání operace Copy File zadat JEHO ID zapůjčení. Zatímco operace kopírování čeká na vyřízení, všechny operace zapůjčení v cílovém souboru selžou se stavovým kódem 409 (konflikt). Nekonečná zapůjčení cílového souboru je tímto způsobem uzamčeno během operace kopírování, ať už kopírujete do cílového souboru, který má jiný název než zdroj, nebo kopírujete do cílového souboru, který má stejný název jako zdroj. Pokud klient v souboru, který ještě neexistuje, určuje ID zapůjčení, vrátí služba Azure Files stavový kód 412 (předběžná podmínka se nezdařila).
Práce s čekající operací kopírování
Operace Copy File může dokončit asynchronní kopírování souborů. Následující tabulka slouží k určení dalšího kroku na základě stavového kódu, který Copy File vrátí:
| Stavový kód | Význam |
|---|---|
| 202 (Přijato), x-ms-copy-status: success | Operace kopírování byla úspěšně dokončena. |
| 202 (přijato), x-ms-copy-status: čeká na vyřízení | Operace kopírování nebyla dokončena. Dotazování cílového objektu blob pomocí Get File Properties k prozkoumání x-ms-copy-status, dokud operace kopírování nedokončí nebo selže. |
| 4xx, 500 nebo 503 | Operace kopírování se nezdařila. |
Během operace Copy File obsahují vlastnosti cílového souboru ID kopie operace Copy File a adresu URL zdrojového objektu blob nebo souboru. Po dokončení operace služba Azure Files zapíše hodnotu času a výsledku (success, failednebo aborted) do vlastností cílového souboru. Pokud má operace failed výsledek, hlavička x-ms-copy-status-description obsahuje řetězec podrobností o chybě.
Čekající operace Copy File má časový limit pro dva týdny. Pokus o kopírování, který se po dvou týdnech nedokončil, a ponechá prázdný soubor s polem x-ms-copy-status nastaveným na failed a pole x-ms-status-description nastaveno na 500 (OperationCancelled). Přerušované, ne závažné chyby, ke kterým může dojít během operace kopírování, může bránit průběhu operace, ale ne způsobit selhání. V těchto případech x-ms-copy-status-description popisuje přerušované chyby.
Jakýkoli pokus o změnu cílového souboru během operace kopírování selže se stavovým kódem 409 (Konflikt), Probíhá kopírování souboru.
Pokud zavoláte operaci Abort Copy File, zobrazí se záhlaví x-ms-copy-status:aborted. Cílový soubor bude mít nedotčená metadata a délku souboru 0 bajtů. Původní volání můžete opakovat Copy File a zkusit operaci znovu.
Fakturování
Cílový účet operace Copy File se účtuje za jednu transakci, aby se operace spustila. Cílový účet také způsobuje jednu transakci pro každou žádost o zrušení nebo vyžádání stavu operace kopírování.
Pokud je zdrojový soubor nebo objekt blob v jiném účtu, za zdrojový účet se účtují náklady na transakce. Kromě toho platí, že pokud se zdrojový a cílový účet nachází v různých oblastech (například USA – sever a USA – jih), bude se šířka pásma, kterou použijete k přenosu požadavku, účtovat do zdrojového účtu jako výchozí přenos dat. Výchozí přenos dat mezi účty ve stejné oblasti je bezplatný.
Viz také
- Operace se soubory
- autorizace požadavků na službu Azure Storage
- Stav a kódy chyb
- kódy chyb služby Azure Files
- přerušit kopírování souboru