Бөлісу құралы:


azcopy copy

Копирует исходные данные в целевое расположение.

Примечание.

AzCopy не поддерживает сценарии, в которых источник или назначение активно изменяются во время передачи.

Краткие сведения

Копирует исходные данные в целевое расположение. Поддерживаются следующие направления:

  • локальная система <-> BLOB-объект Azure (SAS или OAuth)
  • local <—> Файлы Azure (проверка подлинности SAS общего доступа или каталогов или проверка подлинности OAuth)
  • local <—> Azure Data Lake Storage (проверка подлинности SAS, OAuth или SharedKey)
  • BLOB-объект Azure (SAS или общедоступный) -> BLOB-объект Azure (SAS или OAuth)
  • Azure Data Lake Storage (SAS или public) —> Azure Data Lake Storage (SAS или OAuth)
  • Проверка подлинности BLOB-объектов Azure (SAS или OAuth) <—> большой двоичный объект Azure (SAS или OAuth). См . рекомендации.
  • Azure Data Lake Storage (проверка подлинности SAS или OAuth) <—> Azure Data Lake Storage (SAS или OAuth)
  • Azure Data Lake Storage (проверка подлинности SAS или OAuth) <—> БОЛЬШОЙ двоичный объект Azure (SAS или OAuth)
  • BLOB-объект Azure (SAS или общедоступный) -> Файлы Azure (SAS)
  • Файл Azure (аутентификация SAS или OAuth) <—> файл Azure (SAS или OAuth)
  • Файлы 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]

Примеры

Отправьте один файл, используя проверку подлинности 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

Скачайте все версии большого двоичного объекта из служба хранилища Azure, перечисленных в текстовом файле (например, versionidsFileв локальный каталог). Убедитесь, что источник является допустимым 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

Чтобы скопировать файлы, измененные до или после запуска задания AzCopy, AzCopy предоставляет дату и время в журнале заданий в формате ISO8601 (поиск "ISO 8601 START TIME" в журнале заданий), которые можно использовать с --include-after и --include-before флагами ниже. Это полезно для добавочных копий.

Скопируйте подмножество файлов, измененных по заданной дате и времени (в ISO8601 формате) в контейнере с помощью флага 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"

Скопируйте подмножество файлов, измененных до заданной даты и времени (в формате ISO8601) в контейнере с помощью флага 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"

Параметры

--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. Значение по умолчанию — false. Клиент предоставляет ключ по имени, который позволяет клиентам запрашивать хранилище BLOB-объектов Azure возможность предоставлять ключ шифрования на основе каждого запроса. Предоставленный ключ и его хэш извлекается из переменных среды

--decompress. Автоматически распаковывает файлы при скачивании, если параметр content-encoding указывает на то, что они сжаты. Поддерживаемые значения параметра content-encoding: gzip и deflate. Расширения файлов ".gz"/".gzip" или ".zz" не нужны, но удаляются при наличии.

--disable-auto-decoding Значение false по умолчанию, чтобы включить автоматическое декодирование незаконных символов в Windows. Можно задать значение true, чтобы отключить автоматическое декодирование.

--dry-run. Значение по умолчанию — false. Выводит пути к файлам, которые будут скопированы этой командой. Этот флаг не копирует фактические файлы. Флаг --overwrite не действует. Если флаг --overwrite имеет значение false, файлы в исходном каталоге перечислены даже в том случае, если эти файлы существуют в целевом каталоге.

--exclude-attributes (строка) (только для Windows). Исключает файлы, атрибуты которых соответствуют списку атрибутов. Например, A, S, R.

--exclude-blob-type (строка). При необходимости указывает тип большого двоичного объекта (BlockBlob / PageBlob / AppendBlob), который следует исключить при копировании больших двоичных объектов из контейнера или учетной записи. Этот флаг нельзя использовать для копирования данных из сторонних служб в службу Azure. Для разделения объектов следует использовать символ ;.

--exclude-container (строка) Исключите эти контейнеры только при передаче из учетной записи в учетную запись. Несколько контейнеров можно разделить с помощью ";".

--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 загрузит указанные версии в определенную папку назначения.

--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. Сохраняет списки управления доступом между ресурсами с поддержкой (Windows и Файлы Azure или Azure Data Lake Storage в Azure Data Lake Storage). Для учетных записей, имеющих иерархическое пространство имен, субъект безопасности должен быть владельцем целевого контейнера или должен быть назначен роль владельца данных BLOB-объектов хранилища, область действия в целевом контейнере, учетной записи хранения, родительской группе ресурсов или подписке. При скачивании также требуется указать флаг --backup для восстановления разрешений в случаях, когда новый владелец не является пользователем, от чьего лица запущена AzCopy. Этот флаг применяется как к файлам, так и к папкам, если не задан фильтр "Только для файлов" (например, include-pattern).

--preserve-posix-properties. Значение по умолчанию — false. Сохраняет сведения о свойстве, полученные из метаданных объекта или statx из stat нее.

--preserve-smb-info Для расположений с поддержкой SMB флаг по умолчанию имеет значение 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. Значение по умолчанию — false. Сохранение тегов индекса во время службы на передачу из одного хранилища BLOB-объектов в другое

--s2s-preserve-properties Сохранение полных свойств во время службы для копирования служб. Для источников AWS S3 и службы "Файлы Azure", включающих в себя больше одного файла, операция получения списков не возвращает полные свойства объектов и файлов. Чтобы сохранить полные свойства в AzCopy, следует отправить один дополнительный запрос на каждый объект или файл. (Значение по умолчанию — true.)

--trailing-dot Включен по умолчанию для обработки связанных операций с общей папкой безопасным способом. Доступные варианты: Enable, Disable. Выберите Disable , чтобы вернуться к устаревшей (потенциально небезопасной) обработке конечных точек файлов, где служба файлов обрезает все конечные точки в путях. Это может привести к повреждению данных, если передача содержит два пути, которые отличаются только конечными точками (например mypath , и mypath.). Если для этого флага задано Disable значение, а AzCopy обнаруживает конечный dot-файл, он предупреждает клиентов в журнале сканирования, но не попытается прервать операцию. Если назначение не поддерживает конечные файлы точек (хранилище Windows или BLOB-объектов), AzCopy завершится ошибкой, если конечный dot file является корнем передачи и пропускать конечные пути точек, возникающие во время перечисления.

Параметры, наследуемые от родительских команд

--cap-mbps(плавающая точка) Ограничивает скорость передачи данных в Мбит/с. Наблюдаемая пропускная способность может слегка отличаться от предельной. Если установить для этого параметра значение 0 или вообще не указывать значение, пропускная способность не ограничивается.

--log-level (строка). Определяет уровень детализации журнала для файла журнала. Доступные уровни: INFO (все запросы и ответы), WARNING (медленные ответы), ERROR (только невыполненные запросы) и NONE (без выходных журналов). (Значение по умолчанию — INFO). Значение по умолчанию — "INFO".

--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. При указании нескольких значений введите их через точку с запятой.

См. также