Compartilhar via


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.

Confira também