Definições da configuração do AzCopy v10 (Armazenamento do Microsoft Azure)
AzCopy é um utilitário de linha de comando que você pode usar para copiar blobs ou arquivos de ou para uma conta de armazenamento. Este artigo contém uma lista de variáveis de ambiente que você pode usar para configurar o AzCopy v10.
Observação
Se estiver procurando conteúdo para ajudar a começar a usar o AzCopy, confira Introdução ao AzCopy.
Variáveis de ambiente do AzCopy v10
A tabela a seguir descreve cada variável de ambiente e oferece links para o conteúdo que pode ajudar a usar a variável.
| Variável de ambiente | Descrição |
|---|---|
| AWS_ACCESS_KEY_ID | Chave de acesso do Amazon Web Services. Fornece uma chave para autorizar com o Amazon Web Services. Copiar dados do Amazon S3 para o Armazenamento do Microsoft Azure usando o AzCopy |
| AWS_SECRET_ACCESS_KEY | A chave de acesso secreta do Amazon Web Services oferece uma chave secreta para autorizar com o Amazon Web Services. Copiar dados do Amazon S3 para o Armazenamento do Microsoft Azure usando o AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | O ponto de extremidade do Microsoft Entra a ser usado. Essa variável só é usada para logon automático, use o sinalizador de linha de comando ao invocar o comando de logon. |
| AZCOPY_AUTO_LOGIN_TYPE | Defina essa variável como DEVICE, , SPNMSI, AZCLIe PSCRED. Essa variável oferece a capacidade de autorizar sem usar o comando azcopy login. Consulte Autorizar acesso a blobs com AzCopy e Microsoft Entra ID. |
| AZCOPY_BUFFER_GB | Especifique a quantidade máxima de memória do sistema que o AzCopy usará ao baixar e carregar arquivos. Expresse esse valor em gigabytes (GB). Confira Otimizar uso da memória |
| AZCOPY_CACHE_PROXY_LOOKUP | Por padrão, o AzCopy no Windows armazena em cache as pesquisas do servidor proxy no nível do nome do host (sem considerar o caminho do URL). Defina para qualquer outro valor, exceto “true”, para desativar o cache. |
| AZCOPY_CONCURRENCY_VALUE | Especifica o número de solicitações simultâneas que podem ocorrer. Você pode usar essa variável para aumentar a taxa de transferência. Se o computador tiver menos de 5 CPUs, o valor dessa variável será definido como 32. Caso contrário, o valor padrão é igual a 16 multiplicado pelo número de CPUs. O valor padrão máximo dessa variável é 3000, mas você pode aumentar ou reduzir esse valor manualmente. Confira Aumentar a simultaneidade |
| AZCOPY_CONCURRENT_FILES | Substitui o número (aproximado) de arquivos que estão em andamento em qualquer dado momento, controlando a quantidade de arquivos que inicia transferências simultaneamente. |
| AZCOPY_CONCURRENT_SCAN | Controla o grau (máx.) de paralelismo usado durante o exame. Afeta apenas enumeradores paralelizados, que incluem Blobs/Arquivos do Azure e sistemas de arquivos locais. |
| AZCOPY_CONTENT_TYPE_MAP | Substitui um ou mais dos mapeamentos de tipo MIME padrão definidos pelo sistema operacional. Defina esta variável como o caminho de um arquivo JSON que define qualquer mapeamento. Este é o conteúdo de um exemplo de arquivo JSON: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | Ignora a versão da API de serviço para que o AzCopy possa acomodar ambientes personalizados, como o Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Aplica-se somente quando os blobs do Azure são a fonte. A verificação simultânea é mais rápida, mas emprega a API de listagem hierárquica, o que pode resultar em mais IOs/custo. Especifique “true” para sacrificar o desempenho, mas economizar no custo. |
| AZCOPY_DISABLE_SYSLOG | Desabilita o registro em log no Syslog ou no Agente de Eventos do Windows. Por padrão, o AzCopy envia logs para esses canais. Você pode definir essa variável como true se quiser reduzir o ruído no Syslog ou no Log de Eventos do Windows. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Configura o AzCopy para baixar em um caminho temporário antes do download real. Os valores permitidos são true ou false |
| AZCOPY_JOB_PLAN_LOCATION | Substitui o local em que os arquivos de plano de trabalho (usados para acompanhamento e retomada de andamento) são armazenados, para evitar o enchimento de um disco. |
| AZCOPY_LOG_LOCATION | Substitui o local em que os arquivos de log são armazenados, para evitar o preenchimento de um disco. |
| AZCOPY_MSI_CLIENT_ID | O ID do cliente de uma identidade gerenciada atribuída pelo usuário. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como MSI. Confira Autorizar sem um repositório de segredos |
| AZCOPY_MSI_OBJECT_ID | O ID do objeto de uma identidade gerenciada atribuída pelo usuário. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como MSI. Confira Autorizar sem um repositório de segredos |
| AZCOPY_MSI_RESOURCE_STRING | O ID do recurso de uma identidade gerenciada atribuída pelo usuário. Confira Autorizar sem um repositório de segredos |
| AZCOPY_PACE_PAGE_BLOBS | A taxa de transferência para blobs de páginas será ajustada automaticamente para corresponder aos limites de serviço? O padrão é true. Definir como “false” para desabilitar |
| AZCOPY_PARALLEL_STAT_FILES | Faz com que o AzCopy pesquise as propriedades do arquivo em “threads” paralelos ao verificar o sistema de arquivos local. Os threads são retirados do pool definido por AZCOPY_CONCURRENT_SCAN. Definir como “true” pode melhorar o desempenho da verificação no Linux. Não é necessário ou recomendado no Windows. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Defina o número de minutos que o AzCopy deve tentar carregar arquivos para cada solicitação antes de atingir o tempo limite do AzCopy. |
| AZCOPY_SHOW_PERF_STATES | Se definido para qualquer valor, a saída na tela incluirá contagens de partes por estado |
| AZCOPY_SPA_APPLICATION_ID | O ID do aplicativo do registro do aplicativo da sua entidade de serviço. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como SPN. Confira Autorizar sem um repositório de segredos |
| AZCOPY_SPA_CERT_PASSWORD | A senha de um certificado. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como SPN. Confira Autorizar sem um repositório de segredos |
| AZCOPY_SPA_CERT_PATH | O caminho relativo ou totalmente qualificado de um arquivo de certificado. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como SPN. Confira Autorizar sem um repositório de segredos |
| AZCOPY_SPA_CLIENT_SECRET | O segredo do cliente. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como SPN. Confira Autorizar sem um repositório de segredos |
| AZCOPY_TENANT_ID | A ID do locatário do Microsoft Entra a ser usada para logon interativo do dispositivo OAuth. Essa variável só é usada para logon automático, use o sinalizador de linha de comando ao invocar o comando de logon. |
| AZCOPY_TUNE_TO_CPU | Defina como “false” para impedir que o AzCopy leve o uso da CPU em consideração ao ajustar o nível de simultaneidade automática (por exemplo, no comando de parâmetro de comparação). |
| AZCOPY_USER_AGENT_PREFIX | Adicione um prefixo ao agente de usuário do AzCopy padrão, que é usado para fins de telemetria. Um espaço é inserido automaticamente. |
| CPK_ENCRYPTION_KEY | Um valor de chave de criptografia AES-256 codificado em Base64. Essa variável é necessária para solicitações de leitura e gravação ao usar chaves fornecidas pelo cliente para criptografar e descriptografar dados em operações de armazenamento de Blobs. Você pode usar chaves fornecidas pelo cliente definindo o sinalizador --cpk-by-value=true. |
| CPK_ENCRYPTION_KEY_SHA256 | A SHA256 codificada em Base64 da chave de criptografia. Essa variável é necessária para solicitações de leitura e gravação ao usar chaves fornecidas pelo cliente para criptografar e descriptografar dados em operações de armazenamento de Blobs. Você pode usar chaves fornecidas pelo cliente definindo o sinalizador --cpk-by-value=true. |
| GOOGLE_APPLICATION_CREDENTIALS | O caminho absoluto do arquivo de chave de conta de serviço oferece uma chave para autorizar com o armazenamento em nuvem do Google. Copiar dados do Google Cloud Storage para o Armazenamento do Microsoft Azure usando AzCopy (versão prévia) |
| GOOGLE_CLOUD_PROJECT | ID do projeto necessária para passagens de nível de serviço no Google Cloud Storage. |
| HTTPS_PROXY | Define as configurações de proxy do AzCopy. Defina essa variável como o endereço IP e o número da porta do proxy. Por exemplo, xx.xxx.xx.xxx:xx. Se você executar o AzCopy no Windows, o AzCopy detectará automaticamente as configurações de proxy, de modo que você não precisará usar essa configuração no Windows. Se você optar por usar essa configuração no Windows, ela substituirá a detecção automática. Confira Definir configurações de proxy |
Definir configurações de proxy
Para definir as configurações de proxy para AzCopy, defina a variável de ambiente HTTPS_PROXY. Se você executar o AzCopy no Windows, o AzCopy detectará automaticamente as configurações de proxy, de modo que você não precisará usar essa configuração no Windows. Se você optar por usar essa configuração no Windows, ela substituirá a detecção automática.
| Sistema operacional | Comando |
|---|---|
| Windows | No prompt de comando, use: set HTTPS_PROXY=<proxy IP>:<proxy port>No PowerShell, use: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
No momento, o AzCopy não é compatível com proxies que exigem autenticação com NTLM ou Kerberos.
Ignorar um proxy
Se estiver executando o AzCopy no Windows e quiser que ele não use proxy algum (em vez de detectar automaticamente as configurações), use esses comandos. Com essas configurações, o AzCopy não pesquisará nem tentará usar nenhum proxy.
| Sistema operacional | Ambiente | Comandos |
|---|---|---|
| Windows | Prompt de comando (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
Em outros sistemas operacionais, basta deixar a variável de HTTPS_PROXY sem ser definida se não quiser usar nenhum proxy.