Параметры конфигурации AzCopy 10 (служба хранилища Azure)
AzCopy — это служебная программа командной строки, которую можно использовать для копирования больших двоичных объектов или файлов в учетную запись хранения или из нее. Эта статья содержит список переменных среды, которые можно использовать для настройки AzCopy 10.
Примечание.
Если вам требуется информация, которая поможет приступить к работе с AzCopy, см. статью Начало работы с AzCopy.
Переменные среды AzCopy 10
В следующей таблице описаны все переменные среды и предоставлены ссылки на справочную информацию, которая поможет использовать переменные.
| Переменная среды | Description |
|---|---|
| AWS_ACCESS_KEY_ID | Ключ доступа Amazon Web Services. Предоставляет ключ для авторизации в Amazon Web Services. См. статью Копирование данных из Amazon S3 в службу хранилища Azure с помощью AzCopy. |
| AWS_SECRET_ACCESS_KEY | Секретный ключ доступа Amazon Web Services. Предоставляет секретный ключ для авторизации в Amazon Web Services. См. статью Копирование данных из Amazon S3 в службу хранилища Azure с помощью AzCopy. |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Используемая конечная точка Microsoft Entra. Эта переменная используется только для автоматического входа в систему. Используйте вместо нее флаг командной строки в случае вызова команды входа. |
| AZCOPY_AUTO_LOGIN_TYPE | Задайте для этой переменной DEVICEзначение , , MSISPNи PSCREDAZCLI. Эта переменная обеспечивает возможность авторизации без использования команды azcopy login. См. статью "Авторизация доступа к большим двоичным объектам" с помощью AzCopy и идентификатора Microsoft Entra. |
| AZCOPY_BUFFER_GB | Указывает максимальный объем системной памяти, который будет использоваться AzCopy при скачивании и отправке файлов. Выразите это значение в гигабайтах (ГБ). См. статью Оптимизация использования памяти. |
| AZCOPY_CACHE_PROXY_LOOKUP | По умолчанию AzCopy в Windows будет кэшировать поисковые запросы к серверу на уровне имени узла (без учета URL-адреса). Задайте любое значение, отличное от true, чтобы отключить кэширование. |
| AZCOPY_CONCURRENCY_VALUE | Указывает количество одновременных запросов, которые могут быть выполнены. Эту переменную можно использовать для увеличения пропускной способности. Если на компьютере установлено менее 5 ЦП, эта переменная получает значение 32. В противном случае значение по умолчанию равно 16, умноженному на число ЦП. Максимальное значение по умолчанию для этой переменной — 3000. Это значение можно увеличить или уменьшить вручную. См. статью Увеличение параллелизма. |
| AZCOPY_CONCURRENT_FILES | Переопределяет (приблизительное) количество файлов, обрабатываемых одновременно, за счет управления количеством файлов, для которых параллельно инициируются передачи. |
| AZCOPY_CONCURRENT_SCAN | Управляет степенью параллелизма, используемой во время проверки. Влияет только на параллельные перечислители, в том числе Файлы Azure, большие двоичные объекты Azure и локальные файловые системы. |
| AZCOPY_CONTENT_TYPE_MAP | Переопределяет одно или несколько сопоставлений типов MIME по умолчанию, определенных операционной системой. Присвойте этой переменной путь к JSON-файлу, который определяет любое сопоставление. Ниже приведено содержимое примера JSON-файла: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | Переопределяет версию API службы таким образом, чтобы программа AzCopy могла работать с такими пользовательскими средами, как Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Применяется, только если источником являются большие двоичные объекты Azure. Параллельная проверка выполняется быстрее, но используется иерархический список API, что может привести к увеличению числа операций ввода-вывода или затрат. Укажите значение true, чтобы пожертвовать производительностью, но сократить затраты. |
| AZCOPY_DISABLE_SYSLOG | Отключает ведение журнала в системном журнале или средстве ведения журнала событий Windows. По умолчанию AzCopy отправляет журналы в эти каналы. Эту переменную можно задать значение true, если требуется уменьшить шум в системном журнале или журнале событий Windows. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Настраивает AzCopy для скачивания в временный путь перед фактической загрузкой. Допустимые значения: true или false |
| AZCOPY_JOB_PLAN_LOCATION | Переопределяет место хранения файлов плана заданий (используемых для отслеживания хода выполнения и возобновления), чтобы избежать заполнения диска. |
| AZCOPY_LOG_LOCATION | Переопределяет место хранения файлов журнала, чтобы избежать заполнения диска. |
| AZCOPY_MSI_CLIENT_ID | Идентификатор клиента для управляемого удостоверения, назначаемого пользователем. Используйте, если для AZCOPY_AUTO_LOGIN_TYPE задано значение MSI. См. статью Авторизация без хранилища секретов. |
| AZCOPY_MSI_OBJECT_ID | Идентификатор объекта для управляемого удостоверения, назначаемого пользователем. Используйте, если для AZCOPY_AUTO_LOGIN_TYPE задано значение MSI. См. статью Авторизация без хранилища секретов. |
| AZCOPY_MSI_RESOURCE_STRING | Идентификатор ресурса для управляемого удостоверения, назначаемого пользователем. См. статью Авторизация без хранилища секретов. |
| AZCOPY_PACE_PAGE_BLOBS | Должна ли пропускная способность для страничных BLOB-объектов автоматически корректироваться в соответствии с ограничениями службы? Значение по умолчанию — "истина". Установите значение false, чтобы отключить автоматическую корректировку. |
| AZCOPY_PARALLEL_STAT_FILES | Заставляет программу AzCopy искать свойства файла в параллельных потоках при проверке локальной файловой системы. Потоки берутся из пула, определяемого переменной AZCOPY_CONCURRENT_SCAN. При установке значения true может улучшиться производительность проверки в Linux. Не требуется и не рекомендуется для Windows. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Задайте количество минут, которые AzCopy должен попытаться отправить файлы для каждого запроса до истечения времени ожидания AzCopy. |
| AZCOPY_SHOW_PERF_STATES | Если задано какое-либо значение, на экране будет указано количество блоков по состоянию. |
| AZCOPY_SPA_APPLICATION_ID | Идентификатор приложения для регистрации приложения субъекта-службы. Используйте, если для AZCOPY_AUTO_LOGIN_TYPE задано значение SPN. См. статью Авторизация без хранилища секретов. |
| AZCOPY_SPA_CERT_PASSWORD | Пароль сертификата. Используйте, если для AZCOPY_AUTO_LOGIN_TYPE задано значение SPN. См. статью Авторизация без хранилища секретов. |
| AZCOPY_SPA_CERT_PATH | Относительный или полный путь к файлу сертификата. Используйте, если для AZCOPY_AUTO_LOGIN_TYPE задано значение SPN. См. статью Авторизация без хранилища секретов. |
| AZCOPY_SPA_CLIENT_SECRET | Секрет клиента. Используйте, если для AZCOPY_AUTO_LOGIN_TYPE задано значение SPN. См. статью Авторизация без хранилища секретов. |
| AZCOPY_TENANT_ID | Идентификатор клиента Microsoft Entra, используемый для интерактивного входа устройства OAuth. Эта переменная используется только для автоматического входа в систему. Используйте вместо нее флаг командной строки в случае вызова команды входа. |
| AZCOPY_TUNE_TO_CPU | Задайте значение false, чтобы программа AzCopy не учитывала загрузку ЦП в рамках автоматической настройки уровня параллелизма (например, при использовании команды тестирования). |
| AZCOPY_USER_AGENT_PREFIX | Добавление префикса к агенту пользователя AzCopy по умолчанию, который используется в целях телеметрии. Пробел вставляется автоматически. |
| CPK_ENCRYPTION_KEY | Значение ключа шифрования AES-256 в кодировке Base64. Эта переменная необходима для запросов на чтение и запись при использовании предоставленных клиентом ключей для шифрования и расшифровки данных в операциях хранилища BLOB-объектов. Вы можете использовать предоставленные клиентом --cpk-by-value=true ключи, задав флаг. |
| CPK_ENCRYPTION_KEY_SHA256 | Значение SHA256 ключа шифрования в кодировке Base64. Эта переменная необходима для запросов на чтение и запись при использовании предоставленных клиентом ключей для шифрования и расшифровки данных в операциях хранилища BLOB-объектов. Вы можете использовать предоставленные клиентом --cpk-by-value=true ключи, задав флаг. |
| GOOGLE_APPLICATION_CREDENTIALS | Абсолютный путь к файлу ключа учетной записи службы. Предоставляет ключ для авторизации в облачном хранилище Google. См. статью Копирование данных из Google Cloud Storage в службу хранилища Azure с помощью AzCopy (предварительная версия). |
| GOOGLE_CLOUD_PROJECT | Идентификатор проекта, необходимый для обходов уровня обслуживания в Google Cloud служба хранилища. |
| HTTPS_PROXY | Настраивает параметры прокси-сервера для AzCopy. Укажите для этой переменной IP-адрес прокси-сервера и номер порта прокси-сервера. Например, xx.xxx.xx.xxx:xx. Если AzCopy выполняется в среде Windows, средство AzCopy автоматически определяет параметры прокси-сервера, поэтому в Windows этот параметр не нужно использовать. Если вы укажете этот параметр в Windows, он переопределит автоматически определяемое значение. См. статью Настройка параметров прокси-сервера. |
Настройка параметров прокси
Чтобы настроить для AzCopy параметры прокси-сервера, задайте переменную среды HTTPS_PROXY. Если AzCopy выполняется в среде Windows, средство AzCopy автоматически определяет параметры прокси-сервера, поэтому в Windows этот параметр не нужно использовать. Если вы укажете этот параметр в Windows, он переопределит автоматически определяемое значение.
| Операционная система | Get-Help |
|---|---|
| Windows | В командной строке используйте set HTTPS_PROXY=<proxy IP>:<proxy port>.В PowerShell используйте $env:HTTPS_PROXY="<proxy IP>:<proxy port>". |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
В настоящее время AzCopy не поддерживает прокси-серверы, для которых требуется проверка подлинности с помощью NTLM или Kerberos.
Обход прокси-сервера
Если вы используете программу AzCopy в Windows и хотите, чтобы она не использовала прокси-сервер (вместо автоматического обнаружения параметров), используйте эти команды. С этими параметрами AzCopy не будет искать или пытаться использовать прокси-сервер.
| Операционная система | Среда | Команды |
|---|---|---|
| Windows | Командная строка (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
В других операционных системах не определяйте переменную HTTPS_PROXY, если вы не хотите использовать прокси-сервер.