Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
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 или большие двоичные объекты и локальные файловые системы. |
| 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 | Применяется только в том случае, если blob-объекты 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 во время автоматической настройки уровня параллелизма (например, в команде benchmark). |
| AZCOPY_USER_AGENT_PREFIX | Добавьте префикс в агент пользователя AzCopy по умолчанию, который используется для целей телеметрии. Пространство автоматически вставляется. |
| CPK_ENCRYPTION_KEY | Значение ключа шифрования AES-256 в кодировке Base64. Эта переменная необходима для запросов на чтение и запись при использовании предоставленных клиентом ключей для шифрования и расшифровки данных в операциях хранилища BLOB-объектов. Вы можете использовать предоставленные клиентом --cpk-by-value=true ключи, задав флаг. |
| CPK_ENCRYPTION_KEY_SHA256 | В кодировке Base64 SHA256 ключа шифрования. Эта переменная необходима для запросов на чтение и запись при использовании предоставленных клиентом ключей для шифрования и расшифровки данных в операциях хранилища BLOB-объектов. Вы можете использовать предоставленные клиентом --cpk-by-value=true ключи, задав флаг. |
| GOOGLE_APPLICATION_CREDENTIALS | Абсолютный путь к файлу ключа учетной записи службы предоставляет ключ для авторизации с помощью Google Cloud Storage. Копирование данных из Google Cloud Storage в службу хранилища Azure с помощью AzCopy (предварительная версия) |
| GOOGLE_CLOUD_PROJECT | Идентификатор проекта, необходимый для обходов уровня обслуживания в Google Cloud Storage. |
| HTTPS_PROXY | Настраивает параметры прокси-сервера для AzCopy. Задайте для этой переменной IP-адрес прокси-сервера и номер прокси-порта. Например: xx.xxx.xx.xxx:xx. Если вы запускаете AzCopy в Windows, AzCopy автоматически обнаруживает параметры прокси-сервера, поэтому вам не нужно использовать этот параметр в Windows. Если вы решили использовать этот параметр в Windows, он переопределит автоматическое обнаружение. См . раздел "Настройка параметров прокси-сервера" |
Настройка параметров прокси
Чтобы настроить параметры прокси-сервера для AzCopy, задайте HTTPS_PROXY переменную среды. Если вы запускаете AzCopy в Windows, AzCopy автоматически обнаруживает параметры прокси-сервера, поэтому вам не нужно использовать этот параметр в Windows. Если вы решили использовать этот параметр в Windows, он переопределит автоматическое обнаружение.
| Операционная система | Command |
|---|---|
| Виндоус | В командной строке используется: set HTTPS_PROXY=<proxy IP>:<proxy port>В PowerShell используется: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Линукс | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
В настоящее время AzCopy не поддерживает прокси-серверы, требующие проверки подлинности с помощью NTLM или Kerberos.
Обход прокси-сервера
Если вы используете AzCopy в Windows, и вы хотите сказать, что он не использует прокси-сервер вообще (вместо автоматического обнаружения параметров) используйте эти команды. При использовании этих параметров AzCopy не будет искать или пытаться использовать прокси-сервер.
| Операционная система | Окружающая среда | Commands |
|---|---|---|
| Виндоус | Командная строка (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Виндоус | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
В других операционных системах просто оставьте переменную HTTPS_PROXY не задано, если вы хотите использовать прокси-сервер.