Encontrar e alterar a localização dos arquivos compartilhados config e credentials de SDKs e ferramentas da AWS - AWS SDKs e ferramentas
Resolução do diretório inicialAlterar a localização padrão desses arquivos

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á.

Encontrar e alterar a localização dos arquivos compartilhados config e credentials de SDKs e ferramentas da AWS

Os arquivos compartilhados config e credentials da AWS são arquivos de texto sem formatação que contêm informações de configuração para os SDKs e as ferramentas da AWS. Os arquivos residem localmente em seu ambiente e são usados automaticamente por código do SDK ou comandos da AWS CLI que você executa nesse ambiente. Por exemplo, em seu próprio computador ou ao desenvolver em uma instância do Amazon Elastic Compute Cloud.

Quando o SDK ou a ferramenta são executados, eles verificam esses arquivos e carregam todas as configurações disponíveis. Se os arquivos ainda não existirem, um arquivo básico será criado automaticamente pelo SDK ou pela ferramenta.

Por padrão, os arquivos estão em uma pasta denominada .aws que é colocada na sua pasta home ou na pasta do usuário.

Sistema operacional Local padrão e nome dos arquivos
Linux e macOS

~/.aws/config

~/.aws/credentials
Windows

%USERPROFILE%\.aws\config

%USERPROFILE%\.aws\credentials

Resolução do diretório inicial

~ é usado para resolução do diretório inicial apenas quando:

  • Inicia o caminho

  • É seguido imediatamente por / ou por um separador específico da plataforma. No Windows, ~/ e ~\ são resolvidos para o diretório inicial.

Ao determinar o diretório inicial, as seguintes variáveis são verificadas:

  • (Todas as plataformas) A variável de ambiente HOME

  • (Plataformas Windows) A variável de ambiente USERPROFILE

  • (Plataformas Windows) A concatenação das variáveis de ambiente HOMEDRIVE e HOMEPATH ($HOMEDRIVE$HOMEPATH)

  • (Opcional por SDK ou ferramenta) Um SDK ou função de resolução de caminho inicial específica do SDK ou da ferramenta

Quando possível, se o diretório inicial de um usuário for especificado no início do caminho (por exemplo, ~username/), ele será resolvido no diretório inicial do nome de usuário solicitado (por exemplo, /home/username/.aws/config).

Alterar a localização padrão desses arquivos

Você pode usar qualquer uma das opções a seguir para substituir onde esses arquivos são carregados pelo SDK ou pela ferramenta.

Use variáveis de ambiente

As seguintes variáveis de ambiente podem ser definidas para alterar a localização ou o nome desses arquivos do valor padrão para um valor personalizado:

  • config Arquivo de variável de ambiente: AWS_CONFIG_FILE

  • credentials Arquivo de variável de ambiente: AWS_SHARED_CREDENTIALS_FILE

Linux/macOS

Você pode especificar um local alternativo executando os seguintes comandos de exportação no Linux ou no macOS.

$ export AWS_CONFIG_FILE=/some/file/path/on/the/system/config-file-name
$ export AWS_SHARED_CREDENTIALS_FILE=/some/other/file/path/on/the/system/credentials-file-name
Windows

Você pode especificar um local alternativo executando os seguintes comandos setx no Windows.

C:\> setx AWS_CONFIG_FILE c:\some\file\path\on\the\system\config-file-name
C:\> setx AWS_SHARED_CREDENTIALS_FILE c:\some\other\file\path\on\the\system\credentials-file-name

Para obter mais informações sobre a configuração do sistemas usando variáveis de ambiente, consulte Usar variáveis de ambiente para configurar SDKs e ferramentas da AWS globalmente.

Usar propriedade do sistema de JVM

No SDK para Kotlin sendo executado na JVM e no SDK para Java 2.x, você pode definir as seguintes propriedades de sistema de JVM para alterar a localização ou o nome desses arquivos do valor padrão para um valor personalizado:

  • Propriedade do sistema de JVM do arquivo config: aws.configFile

  • credentials Arquivo de variável de ambiente: aws.sharedCredentialsFile

Para obter instruções sobre como definir as propriedades e sistema de JVM, consulte Como definir as propriedades do sistema em JVM. O SDK para Java 1.x não é compatível com essas propriedades de sistema.