azcopy copy
Zkopíruje zdrojová data do cílového umístění.
Poznámka:
AzCopy nepodporuje scénáře, kdy se během přenosu aktivně mění zdroj nebo cíl.
Synopse
Zkopíruje zdrojová data do cílového umístění. Podporované pokyny jsou:
- local <–> Azure Blob (ověřování SAS nebo OAuth)
- místní <–> Azure Files (ověřování SAS sdílené složky nebo adresáře nebo ověřování OAuth)
- local <–> Azure Data Lake Storage (ověřování SAS, OAuth nebo SharedKey)
- Azure Blob (SAS nebo veřejné) –> Azure Blob (ověřování SAS nebo OAuth)
- Azure Data Lake Storage (SAS nebo veřejné) –> Azure Data Lake Storage (ověřování SAS nebo OAuth)
- Azure Blob (SAS nebo ověřování OAuth) <–> Azure Blob (ověřování SAS nebo OAuth) – Viz pokyny.
- Azure Data Lake Storage (ověřování SAS nebo OAuth) <–> Azure Data Lake Storage (ověřování SAS nebo OAuth)
- Azure Data Lake Storage (ověřování SAS nebo OAuth) <–> Azure Blob (ověřování SAS nebo OAuth)
- Azure Blob (SAS nebo veřejný) –> Soubory Azure (SAS)
- Azure File (SAS nebo ověřování OAuth) <–> Azure File (OVĚŘOVÁNÍ SAS nebo OAuth)
- Soubory Azure (SAS) –> Objekt blob Azure (ověřování SAS nebo OAuth)
- AWS S3 (přístupový klíč) –> Objekt blob bloku Azure (ověřování SAS nebo OAuth)
- Cloudové úložiště Google (klíč účtu služby) –> Objekt blob bloku Azure (ověřování SAS nebo OAuth)
Další informace najdete v příkladech.
Rozšířený
AzCopy automaticky zjistí typ obsahu souborů při nahrávání z místního disku na základě přípony souboru nebo obsahu (pokud není zadána žádná přípona).
Integrovaná vyhledávací tabulka je malá, ale v unixu je rozšířená o soubory MIME.types místního systému, pokud jsou dostupné pod jedním nebo více z těchto názvů:
- /etc/mime.types
- /etc/apache2/mime.types
- /etc/apache/mime.types
Ve Windows se typy MIME extrahují z registru. Tuto funkci můžete vypnout pomocí příznaku. Přečtěte si část příznaku.
Pokud nastavíte proměnnou prostředí pomocí příkazového řádku, bude tato proměnná čitelná v historii příkazového řádku. Zvažte vymazání proměnných, které obsahují přihlašovací údaje z historie příkazového řádku. Pokud chcete, aby se proměnné zobrazovaly v historii, můžete pomocí skriptu vyzvat uživatele k zadání přihlašovacích údajů a nastavit proměnnou prostředí.
azcopy copy [source] [destination] [flags]
Související koncepční články
- Začínáme s nástrojem AzCopy
- Přenos dat pomocí nástroje AzCopy a úložiště objektů blob
- Přenos dat s použitím AzCopy a úložiště souborů
Příklady
Nahrajte jeden soubor pomocí ověřování OAuth. Pokud jste se ještě nepřihlásili k AzCopy, spusťte příkaz azcopy login před spuštěním následujícího příkazu.
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"
Stejně jako výše, ale tentokrát také vypočítá hodnotu hash MD5 obsahu souboru a uloží ji jako vlastnost Content-MD5 objektu blob:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5
Nahrajte jeden soubor pomocí tokenu SAS:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Nahrajte jeden soubor pomocí tokenu SAS a propojení (pouze objekty blob bloku):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob
Nahrajte jeden soubor pomocí OAuth a propojení (pouze objekty blob bloku):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob
Nahrajte celý adresář pomocí tokenu SAS:
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
nebo
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --put-md5
Nahrajte sadu souborů pomocí tokenu SAS a zástupných znaků (*):
azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"
Nahrajte soubory a adresáře pomocí tokenu SAS a zástupných znaků (*):
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Nahrajte soubory a adresáře do účtu služby Azure Storage a nastavte značky kódované řetězcem dotazu na objekt blob.
- Pokud chcete nastavit značky {key = "bla bla", val = "foo"} a {key = "bla bla 2", val = "bar"}, použijte následující syntaxi:
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"
- Klíče a hodnoty jsou kódované v adrese URL a páry klíč-hodnota jsou oddělené ampersand('&')
- Při nastavování značek u objektů blob existují v SAS další oprávnění (ne pro značky), bez kterých služba vrací chybu autorizace.
Stáhněte si jeden soubor pomocí ověřování OAuth. Pokud jste se ještě nepřihlásili k AzCopy, spusťte příkaz azcopy login před spuštěním následujícího příkazu.
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"
Stáhněte si jeden soubor pomocí tokenu SAS:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"
Stáhněte si jeden soubor pomocí tokenu SAS a pak výstup prodávali do souboru (pouze objekty blob bloku):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"
Stáhněte si jeden soubor pomocí OAuth a pak výstup přesouvali do souboru (jenom objekty blob bloku):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"
Stáhněte si celý adresář pomocí tokenu SAS:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true
Poznámka o použití zástupné znaky (*) v adresách URL:
Existují jenom dva podporované způsoby použití zástupné znaky v adrese URL.
Jednu můžete použít hned za posledním lomítkem (/) adresy URL. Tím se zkopírují všechny soubory v adresáři přímo do cíle bez jejich umístění do podadresáře.
Můžete také použít jeden v názvu kontejneru, pokud adresa URL odkazuje pouze na kontejner, a ne na objekt blob. Tento přístup můžete použít k získání souborů z podmnožina kontejnerů.
Stáhněte si obsah adresáře bez zkopírování samotného adresáře.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"
Stáhněte si celý účet úložiště.
azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive
Stáhněte podmnožinu kontejnerů v rámci účtu úložiště pomocí zástupného znaku (*) v názvu kontejneru.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive
Stáhněte všechny verze objektu blob ze služby Azure Storage uvedené v textovém souboru (například: versionidsFile
) do místního adresáře. Ujistěte se, že zdrojem je platný objekt blob, cíl je místní složka a versionidsFile
jedná se o textový soubor, ve kterém se každá verze zapisuje na samostatný řádek. Všechny zadané verze se stáhnou do zadané cílové složky.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/another/path/to/dir/[versionidsFile]"
Zkopírujte jeden objekt blob do jiného objektu blob pomocí tokenu SAS.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Zkopírujte jeden objekt blob do jiného objektu blob pomocí tokenu SAS a tokenu OAuth.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"
Zkopírujte jeden virtuální adresář objektů blob do druhého pomocí tokenu SAS:
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Zkopírujte všechny kontejnery objektů blob, adresáře a objekty blob z účtu úložiště do jiného pomocí tokenu SAS:
azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Zkopírujte jeden objekt do služby Blob Storage z AWS Web Services (AWS) S3 pomocí přístupového klíče a tokenu SAS. Nejprve nastavte proměnnou prostředí AWS_ACCESS_KEY_ID a AWS_SECRET_ACCESS_KEY pro zdroj AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Zkopírujte celý adresář do služby Blob Storage z AWS S3 pomocí přístupového klíče a tokenu SAS. Nejprve nastavte proměnnou prostředí AWS_ACCESS_KEY_ID a AWS_SECRET_ACCESS_KEY pro zdroj AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Projděte si https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html lepší pochopení zástupného symbolu [folder].
Zkopírujte všechny kontejnery do služby Blob Storage z Amazon Web Services (AWS) pomocí přístupového klíče a tokenu SAS. Nejprve nastavte proměnnou prostředí AWS_ACCESS_KEY_ID a AWS_SECRET_ACCESS_KEY pro zdroj AWS S3.
azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Zkopírujte všechny kontejnery do služby Blob Storage z oblasti Amazon Web Services (AWS) pomocí přístupového klíče a tokenu SAS. Nejprve nastavte proměnnou prostředí AWS_ACCESS_KEY_ID a AWS_SECRET_ACCESS_KEY pro zdroj AWS S3.
azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Zkopírujte podmnožinu kontejnerů pomocí zástupného znaku (*) v názvu kontejneru. Stejně jako v předchozích příkladech potřebujete přístupový klíč a token SAS. Nezapomeňte nastavit proměnnou prostředí AWS_ACCESS_KEY_ID a AWS_SECRET_ACCESS_KEY pro zdroj AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Zkopírujte objekty blob z jednoho úložiště objektů blob do jiného a zachovejte značky ze zdroje. Pokud chcete zachovat značky, použijte následující syntaxi:
azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --s2s-preserve-blob-tags=true
Přeneste soubory a adresáře do účtu služby Azure Storage a nastavte u objektu blob značky kódované řetězcem dotazu.
Pokud chcete nastavit značky {key = "bla bla", val = "foo"} a {key = "bla bla 2", val = "bar"}, použijte následující syntaxi:
azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"
Klíče a hodnoty jsou kódované v adrese URL a páry klíč-hodnota jsou oddělené ampersand('&')
Při nastavování značek u objektů blob existují další oprávnění (ne pro značky) v SAS, bez kterých služba vrátí chybu autorizace.
Zkopírujte jeden objekt do služby Blob Storage z Google Cloud Storage (GCS) pomocí klíče účtu služby a tokenu SAS. Nejprve nastavte proměnnou prostředí GOOGLE_APPLICATION_CREDENTIALS pro zdroj GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Zkopírujte celý adresář do služby Blob Storage z Google Cloud Storage (GCS) pomocí klíče účtu služby a tokenu SAS. Nejprve nastavte proměnnou prostředí GOOGLE_APPLICATION_CREDENTIALS pro zdroj GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Zkopírujte celý kontejner do služby Blob Storage z Google Cloud Storage (GCS) pomocí klíče účtu služby a tokenu SAS. Nejprve nastavte proměnnou prostředí GOOGLE_APPLICATION_CREDENTIALS pro zdroj GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Zkopírujte všechny kontejnery do služby Blob Storage z Google Cloud Storage (GCS) pomocí klíče účtu služby a tokenu SAS. Nejprve nastavte proměnné prostředí GOOGLE_APPLICATION_CREDENTIALS a GOOGLE_CLOUD_PROJECT=<project-id>
pro zdroj GCS.
azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Zkopírujte podmnožinu kontejnerů pomocí zástupného znaku (*) v názvu kontejneru z Google Cloud Storage (GCS) pomocí klíče účtu služby a tokenu SAS pro cíl. Nejprve nastavte proměnné GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id>
prostředí pro zdroj GCS.
azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Pokud chcete kopírovat soubory změněné před nebo po spuštění úlohy AzCopy, poskytuje AzCopy datum a čas v protokolu úlohy ve formátu ISO8601 (v protokolu úloh vyhledejte ISO 8601 ČAS SPUŠTĚNÍ), který lze použít s příznaky --include-after
a --include-before
příklady níže. To je užitečné pro přírůstkové kopie.
Pomocí příznaku zkopírujte podmnožinu souborů upravených k danému datu a času (ve formátu ISO8601) v kontejneru include-after
.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-after="2020-08-19T15:04:00Z"
Zkopírujte podmnožinu souborů upravených k danému datu a času (ve formátu ISO8601) v kontejneru pomocí příznaku include-before
.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-before="2020-08-19T15:04:00Z"
Možnosti
--as-subdir
True ve výchozím nastavení. Umístí zdroje složek jako podadresáře do cíle. (výchozí true)
--backup
Aktivuje systém Windows SeBackupPrivilege pro odesílání souborů nebo SeRestorePrivilege pro stahování, aby nástroj AzCopy mohl zobrazit čtení všech souborů bez ohledu na jejich oprávnění systému souborů a obnovit všechna oprávnění. Vyžaduje, aby účet, na kterém běží AzCopy, už tato oprávnění má (například oprávnění správce nebo je členem skupiny Backup Operators). Tento příznak aktivuje oprávnění, která už účet má.
--blob-tags
(řetězec) Nastavení značek u objektů blob pro kategorizaci dat v účtu úložiště
--blob-type
(řetězec) Definuje typ objektu blob v cíli. Používá se k nahrávání objektů blob a při kopírování mezi účty (výchozí možnost Detect). Mezi platné hodnoty patří Detect, BlockBlob, PageBlob a AppendBlob. Při kopírování mezi účty způsobí, že hodnota Detect způsobí, že AzCopy použije typ zdrojového objektu blob k určení typu cílového objektu blob. Při nahrávání souboru zjistí, jestli se jedná o soubor VHD nebo VHDX na základě přípony souboru. Pokud se jedná o soubor VHD nebo VHDX, AzCopy tento soubor považuje za objekt blob stránky. (výchozí "Zjistit")
--block-blob-tier
(řetězec) nahrajte objekt blob bloku do služby Azure Storage pomocí této úrovně objektů blob. (výchozí "Žádné")
--block-size-mb
(float) Tuto velikost bloku (zadanou v MiB) použijte při nahrávání do Služby Azure Storage a stahování ze služby Azure Storage. Výchozí hodnota se automaticky vypočítá na základě velikosti souboru. Desetinné zlomky jsou povolené (například: 0,25). Při nahrávání nebo stahování je maximální povolená velikost bloku 0,75 × AZCOPY_BUFFER_GB. Další informace najdete v tématu Optimalizace využití paměti.
--cache-control
(řetězec) Nastavte hlavičku ovládacího prvku mezipaměti. Vráceno při stahování.
--check-length
Zkontrolujte délku souboru v cíli po přenosu. Pokud došlo k neshodě mezi zdrojem a cílem, přenos se označí jako neúspěšný. (výchozí true)
--check-md5
(řetězec) Určuje, jak se mají při stahování ověřit výhradně hodnoty hash MD5. K dispozici pouze při stahování. Dostupné možnosti: NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing. (výchozí 'FailIfDifferent') (výchozí "FailIfDifferent")
--content-disposition
(řetězec) Nastavte hlavičku content-disposition. Vráceno při stahování.
--content-encoding
(řetězec) Nastavte hlavičku kódování obsahu. Vráceno při stahování.
--content-language
(řetězec) Nastavte hlavičku jazyka obsahu. Vráceno při stahování.
--content-type
(řetězec) Určuje typ obsahu souboru. Implikuje typ no-guess-mime. Vráceno při stahování.
--cpk-by-name
(řetězec) Klient poskytnutý podle názvu, který klientům poskytuje požadavky na úložiště objektů blob v Azure, možnost poskytnout šifrovací klíč pro jednotlivé požadavky. Zadaný název klíče se načte ze služby Azure Key Vault a slouží k šifrování dat.
--cpk-by-value
Ve výchozím nastavení je false. Klient poskytnutý názvem, který klientům umožňuje vyžadovat požadavky na úložiště objektů blob v Azure, možnost poskytnout šifrovací klíč pro jednotlivé požadavky. Zadaný klíč a jeho hodnota hash se načítají z proměnných prostředí.
--decompress
Automaticky dekomprimovat soubory při stahování, pokud jejich kódování obsahu indikuje, že jsou komprimované. Podporované hodnoty kódování obsahu jsou gzip a deflate. Přípony souborů ".gz"/'.gzip' nebo '.zz' nejsou nezbytné, ale pokud jsou přítomné, odeberou se.
--disable-auto-decoding
False ve výchozím nastavení umožňuje automatické dekódování neplatných znaků ve Windows. Automatické dekódování je možné nastavit na true.
--dry-run
Ve výchozím nastavení je false. Vytiskne cesty k souborům, které by tento příkaz zkopíroval. Tento příznak nekopíroval skutečné soubory. Příznak --overwrite nemá žádný vliv. Pokud nastavíte příznak --overwrite na false, zobrazí se soubory ve zdrojovém adresáři, i když tyto soubory existují v cílovém adresáři.
--exclude-attributes
(řetězec) (Jenom Windows) Vylučte soubory, jejichž atributy odpovídají seznamu atributů. Příklad: A; S; R
--exclude-blob-type
(řetězec) Volitelně určuje typ objektu blob (BlockBlob, PageBlob nebo AppendBlob), který se má vyloučit při kopírování objektů blob z kontejneru nebo účtu. Použití tohoto příznaku se nevztahuje na kopírování dat z jiných služeb než Azure do služby. Více než jeden objekt blob by měl být oddělen ";".
--exclude-container
(řetězec) Vylučte tyto kontejnery pouze při převodu z účtu na účet. Více kontejnerů je možné oddělit pomocí ";".
--exclude-path
(řetězec) Při kopírování tyto cesty vylučte. Tato možnost nepodporuje zástupné znaky (*). Kontroluje předponu relativní cesty (například: myFolder; myFolder/subDirName/file.pdf). Pokud se používá v kombinaci s procházením účtu, cesty nezahrnují název kontejneru.
--exclude-pattern
(řetězec) Při kopírování tyto soubory vyloučíte. Tato možnost podporuje zástupné znaky (*)
--exclude-regex
(řetězec) Vylučte všechny relativní cesty k souborům, které odpovídají regulárním výrazům. Oddělte regulární výrazy znakem ;.
--follow-symlinks
Při nahrávání z místního systému souborů postupujte podle symbolických odkazů.
--force-if-read-only
Při přepsání existujícího souboru ve Windows nebo službě Azure Files vynuťte, aby přepsání fungovalo i v případě, že má existující soubor nastavený atribut jen pro čtení.
--from-to
(řetězec) Volitelně určuje zdrojovou cílovou kombinaci. Příklad: LocalBlob, BlobLocal, LocalBlobFS. Potrubí: BlobPipe, PipeBlob
-h
, --help
nápověda ke kopírování
--include-after
(řetězec) Zahrnout pouze tyto soubory změněné k danému datu a času nebo za ně. Hodnota by měla být ve formátu ISO8601. Pokud není zadané žádné časové pásmo, předpokládá se, že hodnota je v místním časovém pásmu počítače se spuštěným nástrojem AzCopy. Například 2020-08-19T15:04:00Z
pro čas UTC nebo 2020-08-19
půlnoc (00:00) v místním časovém pásmu. Od verze AzCopy 10.5 platí tento příznak pouze pro soubory, ne složky, takže vlastnosti složky se při použití tohoto příznaku --preserve-smb-info
nebo --preserve-smb-permissions
.
--include-attributes
(řetězec) (Jenom Windows) Zahrnout soubory, jejichž atributy odpovídají seznamu atributů. Příklad: A; S; R
--include-before
(řetězec) Zahrnout pouze tyto soubory změněné před nebo k danému datu a času. Hodnota by měla být ve formátu ISO8601. Pokud není zadané žádné časové pásmo, předpokládá se, že hodnota je v místním časovém pásmu počítače se spuštěným nástrojem AzCopy. Například 2020-08-19T15:04:00Z
pro čas UTC nebo 2020-08-19
pro půlnoc (00:00) v místním časovém pásmu. Od verze AzCopy 10.7 se tento příznak vztahuje pouze na soubory, ne složky, takže vlastnosti složky se při použití tohoto příznaku --preserve-smb-info
--preserve-smb-permissions
nebo .
--include-directory-stub
False ve výchozím nastavení ignoruje zástupné procedury adresáře. Zástupné procedury adresáře jsou objekty blob s metadaty hdi_isfolder:true
. Nastavení hodnoty true zachová zástupné procedury adresáře během přenosů. Zahrnutí tohoto příznaku bez výchozí hodnoty na true (napřazcopy copy --include-directory-stub
. je stejné jako azcopy copy --include-directory-stub=true
).
--include-path
(řetězec) Zahrnout pouze tyto cesty při kopírování. Tato možnost nepodporuje zástupné znaky (*). Kontroluje předponu relativní cesty (například: myFolder; myFolder/subDirName/file.pdf).
--include-pattern
(řetězec) Při kopírování zahrňte pouze tyto soubory. Tato možnost podporuje zástupné znaky (*). Soubory oddělte pomocí ";".
--include-regex
(řetězec) Zahrnout pouze relativní cestu k souborům, které odpovídají regulárním výrazům. Oddělte regulární výrazy znakem ;.
--list-of-versions
(řetězec) Určuje soubor, kde je každé ID verze uvedené na samostatném řádku. Ujistěte se, že zdroj musí odkazovat na jeden objekt blob a všechna ID verzí zadaná v souboru pomocí tohoto příznaku musí patřit pouze do zdrojového objektu blob. AzCopy stáhne zadané verze v zadané cílové složce.
--metadata
(řetězec) Nahrajte do Azure Storage s těmito páry klíč-hodnota jako metadata.
--no-guess-mime-type
Zabrání nástroji AzCopy v detekci typu obsahu na základě přípony nebo obsahu souboru.
--overwrite
(řetězec) Pokud je tento příznak nastavený na hodnotu true, přepište konfliktní soubory a objekty blob v cíli. (výchozí hodnota true) Mezi možné hodnoty patří true, false, prompt a ifSourceNewer. U cílů, které podporují složky, se konfliktní vlastnosti na úrovni složek přepíší, pokud je tento příznak pravdivý nebo pokud se do výzvy zobrazí kladná odpověď. (výchozí hodnota true)
--page-blob-tier
(řetězec) Nahrajte objekt blob stránky do služby Azure Storage pomocí této úrovně objektů blob. (výchozí hodnota None (Žádný). (výchozí "Žádné")
--preserve-last-modified-time
K dispozici pouze v případech, kdy je cílem systém souborů.
--preserve-owner
Ve staženém souboru --preserve-smb-permissions
se projeví pouze při použití. Pokud je hodnota true (výchozí), vlastník souboru a skupina se při stahování zachovají. Pokud je nastavená hodnota false,
--preserve-smb-permissions
zachová seznamy ACL, ale vlastník a skupina jsou založené na uživateli, na kterém běží AzCopy (výchozí hodnota true).
--preserve-permissions
Ve výchozím nastavení je false. Zachovává seznamy ACL mezi prostředky s podporou (Windows a Azure Files nebo Azure Data Lake Storage do Azure Data Lake Storage). U účtů, které mají hierarchický obor názvů, musí být objekt zabezpečení vlastníkem cílového kontejneru nebo musí mít přiřazenou roli Vlastník dat objektů blob služby Storage, vymezený cílový kontejner, účet úložiště, nadřazenou skupinu prostředků nebo předplatné. U stahování budete také potřebovat --backup
příznak k obnovení oprávnění, kde nový vlastník nebude uživatelem, na kterém běží AzCopy. Tento příznak platí pro soubory i složky, pokud není zadaný filtr jen pro soubory (například vzorec zahrnutí).
--preserve-posix-properties
Ve výchozím nastavení je false. Zachovává informace o vlastnosti, které jsou stat
z metadat objektů nebo statx
do metadat objektů.
--preserve-smb-info
U umístění pracujících s protokolem SMB je příznak ve výchozím nastavení nastaven na true. Zachovává informace o vlastnosti SMB (čas posledního zápisu, čas vytvoření, bity atributů) mezi prostředky pracujícími s protokolem SMB (Windows a Soubory Azure). Přenáší se pouze bity atributů podporované službou Azure Files; všechny ostatní se ignorují. Tento příznak platí pro soubory i složky, pokud není zadaný filtr jen pro soubory (například vzorec zahrnutí). Informace přenášené pro složky jsou stejné jako u souborů, s výjimkou Last Write Time
těch, které se u složek nikdy nezachovají. (výchozí true)
--preserve-symlinks
Pokud je tato možnost povolená, cíle symlink se zachovají jako obsah objektu blob, a ne nahrají soubor nebo složku na druhém konci symlinku.
--put-blob-size-mb
Tuto velikost (zadanou v MiB) použijte jako prahovou hodnotu, abyste zjistili, jestli se má při nahrávání do Azure Storage nahrát objekt blob jako jeden požadavek PUT. Výchozí hodnota se automaticky vypočítá na základě velikosti souboru. Desetinné zlomky jsou povolené (například: 0,25).
--put-md5
Vytvořte hodnotu hash MD5 každého souboru a uložte hodnotu hash jako vlastnost Content-MD5 cílového objektu blob nebo souboru. (Ve výchozím nastavení se hodnota hash nevytvořila.) K dispozici pouze při nahrávání.
--recursive
Při nahrávání z místního systému souborů se podívejte na podadresáře rekurzivně.
--s2s-detect-source-changed
Zjistí, jestli se zdrojový soubor nebo objekt blob během čtení změní. (Tento parametr se vztahuje pouze na kopie mezi službami, protože odpovídající kontrola je trvale povolena pro nahrávání a stahování.)
--s2s-handle-invalid-metadata
(řetězec) Určuje způsob zpracování neplatných klíčů metadat. Dostupné možnosti: ExcludeIfInvalid, FailIfInvalid, RenameIfInvalid. (výchozí 'ExcludeIfInvalid'). (výchozí "ExcludeIfInvalid")
--s2s-preserve-access-tier
Zachovat úroveň přístupu během kopírování služby do služby. Informace o horké, studené a archivní úrovni přístupu najdete v Azure Blob Storage a ujistěte se, že cílový účet úložiště podporuje nastavení úrovně přístupu. V případech, kdy nastavení úrovně přístupu není podporované, nezapomeňte použít s2sPreserveAccessTier=false k obejití kopírování úrovně přístupu. (výchozí hodnota true). (výchozí true)
--s2s-preserve-blob-tags
Ve výchozím nastavení je false. Zachování značek indexu během přenosu služby do služby z jednoho úložiště objektů blob do jiného
--s2s-preserve-properties
Zachovat úplné vlastnosti během kopírování služby do služby. U souborů AWS S3 a Azure File, které nejsou jediným zdrojem souborů, operace seznamu nevrací úplné vlastnosti objektů a souborů. Aby se zachovaly úplné vlastnosti, AzCopy musí odeslat jeden další požadavek na objekt nebo soubor. (výchozí true)
--trailing-dot
Ve výchozím nastavení je povolené, aby se operace související se sdílenou složkou byly bezpečně zacházeno. Dostupné možnosti: Enable
, Disable
. Zvolte Disable
, že se vrátíte ke starší verzi (potenciálně nebezpečné) léčbě koncových souborů s tečkami, ve kterých služba file service ořízne všechny koncové tečky v cestách. To může vést k potenciálnímu poškození dat, pokud přenos obsahuje dvě cesty, které se liší pouze koncovou tečkou (například mypath
a mypath.
). Pokud je tento příznak nastavený na a AzCopy narazí na Disable
koncový tečkový soubor, upozorní zákazníky v protokolu prohledávání, ale nepokusí se operaci přerušit. Pokud cíl nepodporuje koncové soubory s tečkou (Windows nebo Blob Storage), AzCopy selže, pokud je koncový bod souboru kořenem přenosu a přeskočí všechny koncové cesty tečky, ke kterým došlo během výčtu.
Možnosti zděděné z nadřazených příkazů
--cap-mbps
(float) Limituje přenosovou rychlost v megabitech za sekundu. Propustnost za okamžik se může mírně lišit od limitu. Pokud je tato možnost nastavená na nulu nebo je vynechána, propustnost není omezena.
--log-level
(řetězec) Definujte úroveň podrobností protokolu pro soubor protokolu, dostupné úrovně: INFO(všechny požadavky/odpovědi), WARNING(pomalé odpovědi), ERROR(pouze neúspěšné požadavky) a NONE (žádné výstupní protokoly). (výchozí 'INFO'). (výchozí "INFORMACE")
--output-type
(řetězec) Formát výstupu příkazu Mezi tyto volby patří: text, json. Výchozí hodnota je text. (výchozí text)
--trusted-microsoft-suffixes
(řetězec) Určuje další přípony domény, kde lze odesílat přihlašovací tokeny Microsoft Entra. Výchozí hodnota je .core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Všechny zde uvedené jsou přidány do výchozího nastavení. Kvůli zabezpečení byste sem měli umístit jenom domény Microsoft Azure. Oddělte více položek středníky.