Usando um HTTP proxy para o AWS CLI - AWS Command Line Interface

Esta documentação é para a AWS CLI única versão 1. Para obter a documentação relacionada à versão 2 do AWS CLI, consulte o Guia do usuário da versão 2.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usando um HTTP proxy para o AWS CLI

Para acessar AWS por meio de servidores proxy, você pode configurar as variáveis de HTTPS_PROXY ambiente HTTP_PROXY e com os nomes de DNS domínio ou endereços IP e números de porta que seus servidores proxy usam.

Como usar os exemplos da

nota

Os exemplos a seguir mostram o nome da variável de ambiente com todas as letras maiúsculas. No entanto, se você especificar uma variável duas vezes usando letras maiúsculas e minúsculas, as minúsculas terão precedência. Recomendamos que você defina cada variável somente uma vez para evitar confusão e comportamento inesperado do sistema.

Os exemplos a seguir mostram como você pode usar o endereço IP explícito do seu proxy ou um DNS nome que se resolva para o endereço IP do seu proxy. Também pode ser seguido por uma vírgula e o número da porta para a qual as consultas devem ser enviadas.

Linux or macOS
$ export HTTP_PROXY=http://10.15.20.25:1234 $ export HTTP_PROXY=http://proxy.example.com:1234 $ export HTTPS_PROXY=http://10.15.20.25:5678 $ export HTTPS_PROXY=http://proxy.example.com:5678
Windows Command Prompt

Como definir para todas as sessões

C:\> setx HTTP_PROXY http://10.15.20.25:1234 C:\> setx HTTP_PROXY http://proxy.example.com:1234 C:\> setx HTTPS_PROXY http://10.15.20.25:5678 C:\> setx HTTPS_PROXY http://proxy.example.com:5678

O uso de setx para definir uma variável de ambiente altera o valor usado na sessão de prompt de comando atual e todas as sessões de prompt de comando que você criar após a execução do comando. Não afeta outros shells de comando que já estejam em execução no momento em que você executar o comando.

Como definir somente para a sessão atual

O uso de set para definir uma variável de ambiente altera o valor usado até o final da sessão de prompt de comando atual ou até que você defina a variável como um valor diferente.

C:\> set HTTP_PROXY=http://10.15.20.25:1234 C:\> set HTTP_PROXY=http://proxy.example.com:1234 C:\> set HTTPS_PROXY=http://10.15.20.25:5678 C:\> set HTTPS_PROXY=http://proxy.example.com:5678

Autenticar para um proxy

O AWS CLI suporta autenticação HTTP básica. Especifique o nome de usuário e a senha no proxyURL, da seguinte forma.

Linux or macOS
$ export HTTP_PROXY=http://username:password@proxy.example.com:1234 $ export HTTPS_PROXY=http://username:password@proxy.example.com:5678
Windows Command Prompt

Como definir para todas as sessões

C:\> setx HTTP_PROXY http://username:password@proxy.example.com:1234 C:\> setx HTTPS_PROXY http://username:password@proxy.example.com:5678

Como definir somente para a sessão atual

C:\> set HTTP_PROXY=http://username:password@proxy.example.com:1234 C:\> set HTTPS_PROXY=http://username:password@proxy.example.com:5678

Usando um proxy em EC2 instâncias da Amazon

Se você configurar um proxy em uma EC2 instância da Amazon lançada com uma IAM função anexada, assegure-se de isentar o endereço usado para acessar os metadados da instância. Para fazer isso, defina a variável de ambiente NO_PROXY como o endereço IP do serviço de metadados da instância 169.254.169.254. Esse endereço não varia.

Linux or macOS
$ export NO_PROXY=169.254.169.254
Windows Command Prompt

Como definir para todas as sessões

C:\> setx NO_PROXY 169.254.169.254

Como definir somente para a sessão atual

C:\> set NO_PROXY=169.254.169.254

Solução de problemas

Se você encontrar problemas com o AWS CLI, consulte as etapas Solução de problemas de erros para o AWS CLI de solução de problemas. Para obter as etapas mais relevantes de solução de problemas, consulte SSLerros de certificado.