Definições de configuração do AzCopy v10 (Armazenamento do Azure)
O AzCopy é um utilitário da linha de comandos que pode utilizar para copiar blobs ou ficheiros de/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.
Nota
Se você estiver procurando conteúdo para ajudá-lo a começar a usar o AzCopy, consulte Introdução ao AzCopy.
Variáveis de ambiente AzCopy v10
A tabela a seguir descreve cada variável de ambiente e fornece links para conteúdo que pode ajudá-lo a usar a variável.
| Variável de ambiente | Description |
|---|---|
| AWS_ACCESS_KEY_ID | Chave de acesso da Amazon Web Services. Fornece uma chave para autorizar com a Amazon Web Services.Copiar dados do Amazon S3 para o Armazenamento do Azure usando o AzCopy |
| AWS_SECRET_ACCESS_KEY | Chave de acesso secreta da Amazon Web Services Fornece uma chave secreta para autorizar com a Amazon Web Services. Copiar dados do Amazon S3 para o Armazenamento do Azure usando o AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | O ponto de extremidade do Microsoft Entra a ser usado. Esta variável é usada apenas para login automático, use o sinalizador de linha de comando em vez disso ao invocar o comando login. |
| AZCOPY_AUTO_LOGIN_TYPE | Defina essa variável como DEVICE, , , AZCLIMSISPNe .PSCRED Esta variável fornece a capacidade de autorizar sem usar o azcopy login comando. 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 você deseja que o AzCopy use ao baixar e carregar arquivos. Expresse esse valor em gigabytes (GB). Consulte Otimizar o uso da memória |
| AZCOPY_CACHE_PROXY_LOOKUP | Por padrão, o AzCopy no Windows armazenará em cache pesquisas do servidor proxy no nível do nome do host (não levando em conta o caminho da URL). Defina como qualquer outro valor que não '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 predefinido é igual a 16 vezes o número de CPUs. O valor padrão máximo dessa variável é 3000, mas você pode definir manualmente esse valor maior ou menor. Consulte Aumentar simultaneidade |
| AZCOPY_CONCURRENT_FILES | Substitui o número (aproximado) de arquivos que estão em andamento a qualquer momento, controlando quantos arquivos iniciamos transferências simultaneamente. |
| AZCOPY_CONCURRENT_SCAN | Controla o grau (máximo) de paralelismo usado durante a varredura. Afeta apenas enumeradores paralelos, que incluem Arquivos/Blobs do Azure e sistemas de arquivos locais. |
| AZCOPY_CONTENT_TYPE_MAP | Substitui um ou mais dos mapeamentos de tipo MIME padrão definidos pelo seu sistema operacional. Defina essa variável como o caminho de um arquivo JSON que define qualquer mapeamento. Aqui está o conteúdo de um arquivo JSON de exemplo: { "MIMETypeMapping": { ".323": "texto/h323", ".aaf": "aplicação/fluxo de octeto", ".aca": "aplicação/fluxo de octeto", ".accdb": "aplicativo/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | Substitui 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 origem. 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 custos. |
| AZCOPY_DISABLE_SYSLOG | Desativa o registo no Syslog ou no Registo 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 fazer o download para um caminho temporário antes do download real. Os valores permitidos são true ou false |
| AZCOPY_JOB_PLAN_LOCATION | Substitui onde os arquivos do plano de trabalho (usados para controle de progresso e retomada) são armazenados, para evitar o enchimento de um disco. |
| AZCOPY_LOG_LOCATION | Substitui onde os arquivos de log são armazenados, para evitar o preenchimento de um disco. |
| AZCOPY_MSI_CLIENT_ID | A ID do cliente de uma identidade gerenciada atribuída pelo usuário. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como MSI. Consulte Autorizar sem uma loja secreta |
| AZCOPY_MSI_OBJECT_ID | A ID do objeto da identidade gerenciada atribuída pelo usuário. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como MSI. Consulte Autorizar sem uma loja secreta |
| AZCOPY_MSI_RESOURCE_STRING | A ID do recurso da identidade gerenciada atribuída pelo usuário. Consulte Autorizar sem uma loja secreta |
| AZCOPY_PACE_PAGE_BLOBS | A taxa de transferência para blobs de página deve ser ajustada automaticamente para corresponder aos limites do Serviço? A predefinição é verdadeiro. Definir como 'false' para desativar |
| AZCOPY_PARALLEL_STAT_FILES | Faz com que o AzCopy procure propriedades de arquivo em 'threads' paralelos ao verificar o sistema de arquivos local. Os fios são desenhados a partir do pool definido por AZCOPY_CONCURRENT_SCAN. Definir isso como true pode melhorar o desempenho da varredura 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 que o AzCopy atinja o tempo limite. |
| AZCOPY_SHOW_PERF_STATES | Se definido, para qualquer coisa, a saída na tela incluirá contagens de partes por estado |
| AZCOPY_SPA_APPLICATION_ID | A ID do aplicativo do registro do aplicativo da entidade de serviço. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como SPN. Consulte Autorizar sem uma loja secreta |
| AZCOPY_SPA_CERT_PASSWORD | A senha de um certificado. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como SPN. Consulte Autorizar sem uma loja secreta |
| AZCOPY_SPA_CERT_PATH | O caminho relativo ou totalmente qualificado para um arquivo de certificado. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como SPN. Consulte Autorizar sem uma loja secreta |
| AZCOPY_SPA_CLIENT_SECRET | O segredo do cliente. Use quando AZCOPY_AUTO_LOGIN_TYPE estiver definido como SPN. Consulte Autorizar sem uma loja secreta |
| AZCOPY_TENANT_ID | O ID de locatário do Microsoft Entra a ser usado para o logon interativo do dispositivo OAuth. Esta variável é usada apenas para login automático, use o sinalizador de linha de comando ao invocar o comando login. |
| AZCOPY_TUNE_TO_CPU | Defina como false para impedir que o AzCopy leve em conta o uso da CPU ao ajustar automaticamente seu nível de simultaneidade (por exemplo, no comando benchmark). |
| AZCOPY_USER_AGENT_PREFIX | Adicione um prefixo ao AzCopy User Agent 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 Blob. Você pode usar as Chaves Fornecidas pelo Cliente definindo o --cpk-by-value=true sinalizador. |
| CPK_ENCRYPTION_KEY_SHA256 | O SHA256 codificado 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 Blob. Você pode usar as Chaves Fornecidas pelo Cliente definindo o --cpk-by-value=true sinalizador. |
| GOOGLE_APPLICATION_CREDENTIALS | O caminho absoluto para o arquivo de chave da conta de serviço fornece uma chave para autorizar com o Google Cloud Storage. Copiar dados do Google Cloud Storage para o Armazenamento do Azure usando o AzCopy (visualização) |
| GOOGLE_CLOUD_PROJECT | ID do projeto necessário para travessias de nível de serviço no Google Cloud Storage. |
| HTTPS_PROXY | Define as configurações de proxy para AzCopy. Defina essa variável como o endereço IP do proxy e o número da porta do proxy. Por exemplo, xx.xxx.xx.xxx:xx. Se executar o AzCopy no Windows, o AzCopy detetará automaticamente as definições de proxy, para que não tenha de utilizar esta definição no Windows. Se optar por utilizar esta definição no Windows, sobrepor-se-á à deteção automática. Consulte Definir configurações de proxy |
Definir configurações de proxy
Para definir as configurações de proxy para AzCopy, defina a HTTPS_PROXY variável de ambiente. Se executar o AzCopy no Windows, o AzCopy detetará automaticamente as definições de proxy, para que não tenha de utilizar esta definição no Windows. Se optar por utilizar esta definição no Windows, sobrepor-se-á à deteção automática.
| Sistema operativo | Comando |
|---|---|
| Windows | Em um prompt de comando, use: set HTTPS_PROXY=<proxy IP>:<proxy port>No uso do PowerShell: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
atualmente, o AzCopy não suporta proxies que exigem a autenticação com o NTLM ou o Kerberos.
Ignorando um proxy
Se você estiver executando o AzCopy no Windows e quiser dizer a ele para não usar nenhum proxy (em vez de detetar automaticamente as configurações), use esses comandos. Com essas configurações, o AzCopy não procurará ou tentará usar qualquer proxy.
| Sistema operativo | 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 HTTPS_PROXY desdefinida se você quiser usar nenhum proxy.