AWS Command Line Interface
Guia do usuário

Perfis nomeados

A AWS CLI oferece suporte usando qualquer um dos vários perfis nomeados armazenados nos credentials arquivos config. Você pode configurar perfis adicionais usando aws configure com a opção --profile ou adicionando entradas aos arquivos config e credentials.

O exemplo a seguir mostra um arquivo credentials com dois perfis. O primeiro é usado quando você executa um comando da CLI sem perfil. O segundo é usado quando você executa um comando da CLI com o parâmetro --profile user1.

~/.aws/credentials (Linux e Mac) ou %USERPROFILE%\.aws\credentials (Windows)

[default] aws_access_key_id=AKIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY [user1] aws_access_key_id=AKIAI44QH8DHBEXAMPLE aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY

Cada perfil usa credenciais diferentes — talvez provenientes de usuários diferentes do IAM — e também pode especificar regiões da AWS e formatos de saída diferentes.

~/.aws/config (Linux e Mac) ou %USERPROFILE%\.aws\config (Windows)

[default] region=us-west-2 output=json [profile user1] region=us-east-1 output=text

Importante

O arquivo credentials usa um formato de nomeação diferente do que o arquivo config da CLI para perfis nomeados. Inclua o prefixo "profile" somente ao configurar um perfil nomeado no arquivo config. Não use o profile ao configurar o arquivo credentials.

Usar perfis com o AWS CLI

Para usar um perfil designado, adicione a opção --profile profile-name para o comando. O exemplo a seguir lista todas as suas instâncias do Amazon EC2 usando o perfil user1 dos arquivos de exemplo anteriores.

$ aws ec2 describe-instances --profile user1

Para usar um perfil designado para vários comandos, evite especificar o perfil ao configurar o comando em cada variável de ambiente AWS_DEFAULT_PROFILE na linha de comando.

Linux, macOS, or Unix

$ export AWS_DEFAULT_PROFILE=user1

Configurar a variável de ambiente altera o perfil padrão até o final do seu shell sessão ou até que você defina a variável a um valor diferente. Você pode tornar as variáveis de ambiente persistentes em sessões futuras colocando-as no script de inicialização do shell. Para obter mais informações, consulte Variáveis de ambiente.

Windows

C:\> setx AWS_DEFAULT_PROFILE user1

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. O uso de setx para definir uma variável de ambiente altera o valor usado no shell de comando atual e em todos os shells 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.

Nesta página: