azcopy copy
Копирует исходные данные в целевое расположение.
Краткие сведения
Копирует исходные данные в целевое расположение. Поддерживаются следующие направления:
- локальная система <-> BLOB-объект Azure (SAS или OAuth)
- локальная система <-> Файлы Azure (доступк к общему ресурсу/каталогу через SAS)
- локальная система <-> Azure Data Lake Storage 2-го поколения (проверка подлинности SAS, OAuth или SharedKey)
- BLOB-объект Azure (SAS или общедоступный) -> BLOB-объект Azure (SAS или OAuth)
- Azure Data Lake Storage 2-го поколения (SAS или общедоступная) —> Azure Data Lake Storage 2-го поколения (проверка подлинности SAS или OAuth)
- Проверка подлинности BLOB-объектов Azure (SAS или OAuth) <—> большой двоичный объект Azure (SAS или OAuth). См . рекомендации.
- Azure Data Lake Storage 2-го поколения (аутентификация SAS или OAuth) <—> Azure Data Lake Storage 2-го поколения (аутентификация SAS или OAuth)
- Azure Data Lake Storage 2-го поколения (аутентификация SAS или OAuth) <—> большой двоичный объект Azure (SAS или OAuth)
- BLOB-объект Azure (SAS или общедоступный) -> Файлы Azure (SAS)
- Файлы Azure (SAS) -> Файлы Azure (SAS)
- Файлы Azure (SAS) -> BLOB-объект Azure (SAS или OAuth)
- AWS S3 (ключ доступа) -> блочный BLOB-объект Azure (проверка подлинности SAS или OAuth)
- Google Cloud Storage (ключ учетной записи службы) -> блочный BLOB-объект Azure (проверка подлинности SAS или OAuth)
Дополнительные сведения см. в примерах.
Расширенные
При отправке с локального диска AzCopy автоматически определяет тип содержимого файлов на основе расширения или содержимого файла (если расширение не указано).
Встроенная таблица подстановки небольшая, но в Unix она дополняется файлами mime.types локальной системы, если они доступны по одному или нескольким из следующих имен:
- /etc/mime.types
- /etc/apache2/mime.types
- /etc/apache/mime.types
В Windows типы MIME извлекаются из реестра. Эта функция может быть отключена с помощью флага. См. раздел о флаге.
Если задать переменную среды с помощью командной строки, эта переменная доступна для чтения в журнале командной строки. Рассмотрите возможность очистки переменных, содержащих учетные данные, из журнала командной строки. Чтобы переменные не отображались в журнале, можно использовать сценарий, чтобы запросить у пользователя учетные данные и задать переменную среды.
azcopy copy [source] [destination] [flags]
Статьи по теме
- Начало работы с AzCopy
- Передача данных с помощью AzCopy и хранилища BLOB-объектов
- Перенос данных с помощью AzCopy и хранилища файлов
Примеры
Отправьте один файл, используя проверку подлинности OAuth. Если вы еще не вошли в AzCopy, выполните команду azcopy login перед выполнением следующей команды.
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"
Эта команда не отличается от приведенной выше, но теперь с ее помощью также можно вычислить хэш MD5 содержимого файла и сохранить его как свойство Content-MD5 BLOB-объекта:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5
Отправьте один файл, используя маркер SAS:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Отправьте файл, используя маркер SAS и конвейер (только для блочных BLOB-объектов):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob
Отправьте файл, используя OAuth и конвейер (только для блочных BLOB-объектов):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob
Отправьте весь каталог, используя маркер SAS:
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
or
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --put-md5
Отправьте набор файлов, используя маркер SAS и подстановочные знаки (*):
azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"
Отправьте файлы и каталоги, используя маркер SAS и подстановочные знаки (*):
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Отправьте файлы и каталоги в учетную запись службы хранилища Microsoft Azure и задайте теги в кодировке строки запроса для большого двоичного объекта.
- Чтобы задать теги {key = "bla bla", val = "foo"} и {key = "bla bla 2", val = "bar"}, используйте следующий синтаксис:
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"- Ключи и значения кодируются в URL-адресе, а пары "ключ-значение" разделяются символом "&".
- При настройке тегов больших двоичных объектов в SAS есть больше разрешений (не для тегов), без которых служба возвращает ошибку авторизации.
Скачайте один файл, используя проверку подлинности OAuth. Если вы еще не вошли в AzCopy, выполните команду azcopy login перед выполнением следующей команды.
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"
Скачайте один файл, используя маркер SAS:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"
Скачайте один файл, используя маркер SAS, а затем отправьте выходные данные в файл (только для блочных BLOB-объектов):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"
Скачайте один файл, используя OAuth, а затем отправьте выходные данные в файл (только для блочных BLOB-объектов):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"
Скачайте весь каталог, используя маркер SAS:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true
Примечание об использовании подстановочного знака (*) в URL-адресах:
Существует два способа использования подстановочных знаков в URL-адресе.
Подстановочный знак можно добавить сразу после последней косой черты (/) URL-адреса. При этом все файлы в каталоге копируются непосредственно в место назначения без помещения в подкаталог.
Подстановочный знак можно также использовать в имени контейнера, если URL-адрес относится только к контейнеру, а не к большому двоичному объекту. Этот подход можно использовать для получения файлов из подмножества контейнеров.
Скачайте содержимое каталога, не копируя сам каталог.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"
Скачайте всю учетную запись хранения.
azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive
Скачайте подмножество контейнеров из учетной записи хранения, используя подстановочный знак (*) для имени контейнера.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive
Скачайте все версии BLOB-объекта из службы хранилища Azure в локальный каталог. Убедитесь, что источником является допустимый BLOB-объект, назначением — локальная папка и versionidsFile, который принимает путь к файлу, где каждая версия записывается в отдельной строке. Все указанные версии скачиваются в указанной целевой папке.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/another/path/to/dir/[versionidsFile]"
Скопируйте один большой двоичный объект в другой, используя маркер 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]"
Скопируйте один большой двоичный объект в другой, используя маркер SAS и токен OAuth.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"
Скопируйте один виртуальный каталог больших двоичных объектов в другой, используя маркер 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
Скопируйте все контейнеры больших двоичных объектов, каталоги и большие двоичные объекты из учетной записи хранения в другую, используя маркер SAS:
azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Скопируйте один объект в хранилище BLOB-объектов из Amazon Web Services (AWS) S3, используя ключ доступа и маркер SAS. Сначала задайте переменные среды AWS_ACCESS_KEY_ID и AWS_SECRET_ACCESS_KEY для источника AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Скопируйте весь каталог в хранилище BLOB-объектов из AWS S3, используя ключ доступа и маркер SAS. Сначала задайте переменные среды AWS_ACCESS_KEY_ID и AWS_SECRET_ACCESS_KEY для источника AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Дополнительные сведения о заполнителе [folder] см. по ссылке https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html.
Скопируйте все контейнеры в хранилище BLOB-объектов из Amazon Web Services (AWS) S3, используя ключ доступа и маркер SAS. Сначала задайте переменные среды AWS_ACCESS_KEY_ID и AWS_SECRET_ACCESS_KEY для источника AWS S3.
azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Скопируйте все контейнеры в хранилище BLOB-объектов из региона Amazon Web Services (AWS) S3, используя ключ доступа и маркер SAS. Сначала задайте переменные среды AWS_ACCESS_KEY_ID и AWS_SECRET_ACCESS_KEY для источника AWS S3.
azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Скопируйте подмножество контейнеров, используя подстановочный знак (*) для имени контейнера. Как и в предыдущих примерах, вам нужен ключ доступа и маркер SAS. Убедитесь, что переменные среды AWS_ACCESS_KEY_ID и AWS_SECRET_ACCESS_KEY для источника AWS S3 заданы.
azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Скопируйте большие двоичные объекты из одного хранилища BLOB-объектов в другое и сохраните теги из источника. Чтобы сохранить теги, используйте следующий синтаксис:
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
Передайте файлы и каталоги в учетную запись службы хранилища Microsoft Azure и задайте указанные теги в кодировке строки запроса для большого двоичного объекта.
Чтобы задать теги {key = "bla bla", val = "foo"} и {key = "bla bla 2", val = "bar"}, используйте следующий синтаксис:
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"Ключи и значения кодируются в URL-адресе, а пары "ключ-значение" разделяются символом "&".
При задании тегов для больших двоичных объектов в SAS следует добавить дополнительные разрешения (t для тегов), в противном случае служба будет выдавать ошибку авторизации.
Скопируйте один объект в Хранилище BLOB-объектов из Google Cloud Storage (GCS) с помощью ключа учетной записи службы и маркера SAS. Сначала задайте переменную среды GOOGLE_APPLICATION_CREDENTIALS для источника GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Скопируйте весь каталог в Хранилище BLOB-объектов из Google Cloud Storage (GCS) с помощью ключа учетной записи службы и маркера SAS. Сначала задайте переменную среды GOOGLE_APPLICATION_CREDENTIALS для источника GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Скопируйте весь контейнер в Хранилище BLOB-объектов из Google Cloud Storage (GCS) с помощью ключа учетной записи службы и маркера SAS. Сначала задайте переменную среды GOOGLE_APPLICATION_CREDENTIALS для источника GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Скопируйте все контейнеры в хранилище BLOB-объектов из Google Cloud Storage (GCS) с помощью ключа учетной записи службы и маркера SAS. Сначала задайте переменные среды GOOGLE_APPLICATION_CREDENTIALS и GOOGLE_CLOUD_PROJECT=<project-id> для источника GCS
azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Скопируйте подмножество контейнеров из Google Cloud Storage (GCS) с помощью ключа учетной записи службы и маркера SAS для назначения, используя подстановочный знак (*) для имени контейнера. Сначала задайте переменные среды GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id> для источника GCS
azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Параметры
--as-subdir по умолчанию имеет значение True. Размещает источники папок как подкаталоги в назначении. (Значение по умолчанию — true.)
--backup. Активирует привилегию Windows SeBackupPrivilege для отправки или SeRestorePrivilege для загрузки, чтобы позволить AzCopy просматривать и читать все файлы, независимо от их разрешений файловой системы, и восстанавливать все разрешения. Требует, чтобы учетная запись, в которой запущена AzCopy, уже имела эти разрешения (например, имела права администратора или являлась членом группы "Операторы архива"). Этот флаг активирует привилегии, которые уже есть у учетной записи
--blob-tags (строка). Задает теги в больших двоичных объектах для категоризации данных в учетной записи хранения
--blob-type (строка). Определяет тип большого двоичного объекта в назначении. Используется для передачи больших двоичных объектов и при копировании между учетными записями (значение по умолчанию Detect). Допустимые значения: Detect, BlockBlob, PageBlob и AppendBlob. При копировании между учетными записями значение Detect дает AzCopy возможность использовать тип исходного BLOB-объекта для определения типа целевого BLOB-объекта. При отправке файла значение Detect определяет тип файла (VHD или VHDX) на основе его расширения. AzCopy обрабатывает файлы VHD и VHDX как страничные BLOB-объекты. (значение по умолчанию — "Detect")
--block-blob-tier (строка). Передает блочный BLOB-объект в службу хранилища Azure с помощью этого уровня BLOB-объектов. (значение по умолчанию — "None")
--block-size-mb (число с плавающей точкой). Используйте этот размер блока (указанный в МиБ) при отправке в службу хранилища Azure или скачивании из нее. Значение по умолчанию рассчитывается автоматически в зависимости от размера файла. Допускаются десятичные дроби (например, 0,25). При отправке или скачивании максимальный допустимый размер блока составляет 0,75 * AZCOPY_BUFFER_GB. Дополнительные сведения см. в статье "Оптимизация использования памяти".
--cache-control (строка). Задает заголовок cache-control. Возвращается при скачивании.
--check-length Проверьте длину файла в назначении после передачи. В случае несоответствия между источником и назначением перенос помечается как failed. (Значение по умолчанию — true.)
--check-md5 (строка). Указывает, насколько строго должны проверяться хэши MD5 при скачивании. Доступна только при скачивании. Доступные параметры: NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing. (Значение по умолчанию FailIfDifferent) (Значение по умолчанию — FailIfDifferent)
--content-disposition (строка). Задает заголовок content-disposition. Возвращается при скачивании.
--content-encoding (строка). Задает заголовок content-encoding. Возвращается при скачивании.
--content-language (строка). Задает заголовок content-language. Возвращается при скачивании.
--content-type (строка). Указывает тип содержимого файла. Подразумевает использование типа содержимого no-guess-mime-type. Возвращается при скачивании.
--cpk-by-name (строка) Клиент предоставил ключ по имени, который предоставляет клиентам запросы к хранилищу BLOB-объектов Azure, чтобы предоставить ключ шифрования на основе каждого запроса. Предоставленное имя ключа извлекается из Azure Key Vault и используется для шифрования данных.
--cpk-by-value Клиент предоставляет ключ по имени, который позволяет клиентам запрашивать хранилище BLOB-объектов Azure возможность предоставлять ключ шифрования на основе каждого запроса. Предоставленный ключ и его хэш извлекается из переменных среды
--decompress. Автоматически распаковывает файлы при скачивании, если параметр content-encoding указывает на то, что они сжаты. Поддерживаемые значения параметра content-encoding: gzip и deflate. Расширения файлов ".gz"/".gzip" или ".zz" не нужны, но удаляются при наличии.
--disable-auto-decoding Значение false по умолчанию, чтобы включить автоматическое декодирование незаконных символов в Windows. Можно задать значение true, чтобы отключить автоматическое декодирование.
--dry-run Выводит пути к файлам, которые будут скопированы этой командой. Этот флаг не копирует фактические файлы. Флаг --overwrite не действует. Если флаг --overwrite имеет значение false, файлы в исходном каталоге перечислены даже в том случае, если эти файлы существуют в целевом каталоге.
--exclude-attributes (строка) (только для Windows). Исключает файлы, атрибуты которых соответствуют списку атрибутов. Например, A, S, R.
--exclude-blob-type (строка). При необходимости указывает тип большого двоичного объекта (BlockBlob / PageBlob / AppendBlob), который следует исключить при копировании больших двоичных объектов из контейнера или учетной записи. Этот флаг нельзя использовать для копирования данных из сторонних служб в службу Azure. Для разделения объектов следует использовать символ ;.
--exclude-path (строка). Исключает указанные пути при копировании. Этот параметр не поддерживает подстановочные знаки (*). Проверяет префикс относительного пути (например, myFolder;myFolder/subDirName/file.pdf). При использовании этого параметра в сочетании с обходом учетной записи пути не включают имя контейнера.
--exclude-pattern (строка). Исключает указанные файлы при копировании. Этот параметр поддерживает подстановочные знаки (*)
--exclude-regex (строка). Исключает все относительные пути файлов, соответствующие регулярным выражениям. Разделяйте регулярные выражения символом ';'.
--follow-symlinks Следуйте символьным ссылкам при отправке из локальной файловой системы.
--force-if-read-only. Обеспечивает принудительную перезапись существующего файла в Windows или службе "Файлы Azure", даже если у этого файла установлен атрибут только для чтения.
--from-to (строка). Дополнительно задает комбинацию назначения источника. Например: LocalBlob, BlobLocal, LocalBlobFS. Передача: BlobPipe, PipeBlob
-h, --help. Справка по копированию
--include-after (строка). Включает только те файлы, которые были изменены в указанные дату и время или после них. Значение должно быть указано в формате ISO8601. Если часовой пояс не указан, предполагается, что значение находится в локальном часовом поясе компьютера, на котором выполняется AzCopy. Например, 2020-08-19T15:04:00Z для времени в формате UTC или 2020-08-19 для полуночи (00:00) в местном часовом поясе. Начиная с AzCopy 10.5 этот флаг применяется только к файлам, а не к папкам, поэтому свойства папки не копируются при одновременном использовании этого флага с параметрами --preserve-smb-info или --preserve-smb-permissions.
--include-attributes (строка) (только для Windows). Включает файлы, атрибуты которых соответствуют списку атрибутов. Например, A, S, R.
--include-before (строка). Включает только файлы, которые были изменены в указанные дату и время или до них. Значение должно быть указано в формате ISO8601. Если часовой пояс не указан, предполагается, что значение находится в локальном часовом поясе компьютера, на котором выполняется AzCopy. Например, 2020-08-19T15:04:00Z для времени в формате UTC или 2020-08-19 для полуночи (00:00) в местном часовом поясе. Начиная с AzCopy 10.7 этот флаг применяется только к файлам, а не к папкам, поэтому свойства папки не копируются при одновременном использовании этого флага с параметрами --preserve-smb-info или --preserve-smb-permissions.
--include-directory-stub Значение false по умолчанию, чтобы игнорировать заглушки каталога. Заглушки каталогов — это большие двоичные объекты с метаданными hdi_isfolder:true. Если установить значение true, заглушки каталогов будут сохранены во время передачи. Включение этого флага без значения по умолчанию имеет значение true (например,azcopy copy --include-directory-stub совпадает с azcopy copy --include-directory-stub=true).
--include-path (строка). При копировании включает только указанные пути. Этот параметр не поддерживает подстановочные знаки (*). Проверяет префикс относительного пути (например, myFolder;myFolder/subDirName/file.pdf).
--include-pattern (строка). При копировании включает только указанные файлы. Этот параметр поддерживает подстановочные знаки (*). Для разделения файлов используйте символ ;.
--include-regex (строка). Включает только относительные пути файлов, соответствующие регулярным выражениям. Разделяйте регулярные выражения символом ';'.
--list-of-versions (строка) — определение файла, в котором каждый идентификатор версии указан в отдельной строке. Убедитесь, что источник указывает на один BLOB-объект, а все идентификаторы версий, перечисленные в файле при использовании этого флага, принадлежат только к исходному BLOB-объекту. AzCopy загрузит указанные версии в определенную папку назначения.
--log-level (строка). Определяет уровень детализации журнала для файла журнала. Доступные уровни: INFO (все запросы и ответы), WARNING (медленные ответы), ERROR (только невыполненные запросы) и NONE (без выходных журналов). (Значение по умолчанию — INFO). Значение по умолчанию — "INFO".
--metadata (строка). Отправляет пары "ключ-значение" в службу хранилища Azure в качестве метаданных.
--no-guess-mime-type Запрещает AzCopy обнаруживать тип контента на основе расширения или содержимого файла.
--overwrite (строка). Перезаписывает конфликтующие файлы и BLOB-объекты в назначении, если для этого флага установлено значение true. (значение по умолчанию — true). Возможные значения: true, false, prompt и ifSourceNewer. Для назначений, поддерживающих папки, конфликтующие свойства уровня папок перезаписываются, если этот флаг имеет значение true или если положительный ответ предоставляется запросу. Значение по умолчанию: true.
--page-blob-tier (строка). Передает страничный BLOB-объект в службу хранилища Azure с помощью этого уровня BLOB-объектов. (значение по умолчанию — None). (значение по умолчанию — "None")
--preserve-last-modified-time Доступно только в том случае, если назначение — файловая система.
--preserve-owner Действует только при загрузке и только в том случае, если --preserve-smb-permissions он используется. Если задано значение true (значение по умолчанию), в файлах для загрузки сохраняются сведения о владельце файла и группе. Если задано значение false,
--preserve-smb-permissions по-прежнему сохраняет списки управления доступом, но владелец и группа основаны на пользователе, работающем AzCopy (по умолчанию true)
--preserve-permissions. Значение по умолчанию — false. Сохраняет списки ACL между ресурсами (Windows и Файлами Azure или Azure Data Lake Storage 2-го поколения с Azure Data Lake Storage 2-го поколения). Для учетных записей с иерархическим пространством имен субъект безопасности должен быть владельцем целевого контейнера или должен быть назначен роль владельца данных больших двоичных объектов служба хранилища, область целевому контейнеру, учетной записи хранения, родительской группе ресурсов или подписке. При скачивании также требуется указать флаг --backup для восстановления разрешений в случаях, когда новый владелец не является пользователем, от чьего лица запущена AzCopy. Этот флаг применяется как к файлам, так и к папкам, если не задан фильтр "Только для файлов" (например, include-pattern).
--preserve-smb-infoДля расположений с поддержкой S МБ флаг по умолчанию имеет значение true. Сохраняет сведения о свойстве SMB (последнее время записи, время создания, биты атрибутов) при передаче элементов между ресурсами, поддерживающими SMB (Windows и служба "Файлы Azure"). Передаются только биты атрибутов, поддерживаемые Файлы Azure; все остальные игнорируются. Этот флаг применяется как к файлам, так и к папкам, если не задан фильтр "Только для файлов" (например, include-pattern). Данные, передаваемые для папок, совпадают с файлами, за исключением Last Write Time, которое не сохраняется для папок. (Значение по умолчанию — true.)
--preserve-symlinks Если этот параметр включен, назначения symlink сохраняются в виде содержимого БОЛЬШОго двоичного объекта, а не отправляют файл или папку в другом конце симплики.
--put-blob-size-mbИспользуйте этот размер (указанный в MiB) в качестве порогового значения, чтобы определить, следует ли отправлять большой двоичный объект в виде одного запроса PUT при отправке в служба хранилища Azure. Значение по умолчанию рассчитывается автоматически в зависимости от размера файла. Допускаются десятичные дроби (например, 0,25).
--put-md5 Создайте хэш MD5 каждого файла и сохраните хэш в качестве свойства Content-MD5 целевого большого двоичного объекта или файла. (По умолчанию хэш НЕ создается.) Доступно только при отправке.
--recursive Рекурсивно просматривайте подкаталоги при отправке из локальной файловой системы.
--s2s-detect-source-changed Определите, изменяется ли исходный файл или большой двоичный объект во время чтения. (Этот параметр применяется только при копировании между службами, так как соответствующая проверка для отправки и скачивания постоянно включена.)
--s2s-handle-invalid-metadata (строка). Указывает способ обработки для недопустимых ключей метаданных. Доступные варианты: ExcludeIfInvalid, FailIfInvalid, RenameIfInvalid. (Значение по умолчанию — ExcludeIfInvalid). (Значение по умолчанию — "ExcludeIfInvalid").
--s2s-preserve-access-tier. Позволяет сохранить уровень доступа при копировании между службами. Дополнительные сведения см. в статье Хранилище BLOB-объектов Azure: горячий, холодный и архивный уровни доступа, чтобы убедиться, что целевая учетная запись хранения поддерживает настройку уровня доступа. Если настройка уровня доступа не поддерживается, не забудьте использовать s2sPreserveAccessTier=false, чтобы обойти уровень доступа при копировании. (Значение по умолчанию — true). (Значение по умолчанию — true.)
--s2s-preserve-blob-tags (строка). Сохраняет теги индекса во время передачи между службами из одного хранилища BLOB-файлов в другое
--s2s-preserve-properties Сохранение полных свойств во время службы для копирования служб. Для источников AWS S3 и службы "Файлы Azure", включающих в себя больше одного файла, операция получения списков не возвращает полные свойства объектов и файлов. Чтобы сохранить полные свойства в AzCopy, следует отправить один дополнительный запрос на каждый объект или файл. (Значение по умолчанию — true.)
Параметры, наследуемые от родительских команд
--cap-mbps(плавающая точка) Ограничивает скорость передачи данных в Мбит/с. Наблюдаемая пропускная способность может слегка отличаться от предельной. Если установить для этого параметра значение 0 или вообще не указывать значение, пропускная способность не ограничивается.
--output-type (строка) Формат выходных данных команды. Возможные варианты: text, json. Значение по умолчанию — text.
--trusted-microsoft-suffixes (строка) Указывает дополнительные суффиксы домена, в которых можно отправлять маркеры входа Microsoft Entra. Значение по умолчанию: .core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net. Все перечисленные здесь домены добавлены по умолчанию. Для безопасности здесь следует указывать только домены Microsoft Azure. При указании нескольких значений введите их через точку с запятой.