Localização do compartilhado de arquivos config e credentials compartilhados - AWS SDKs e ferramentas

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

Localização do compartilhado de arquivos config e credentials compartilhados

Os arquivos compartilhados AWS config e são credentials arquivos de texto simples que contêm informações de configuração para os AWS SDKs e as ferramentas. Os arquivos residem localmente em seu ambiente e são usados automaticamente pelo código do SDK ou pelos AWS CLI comandos 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 chamada .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

~só é usado para resolução de diretórios pessoais quando:

  • Inicia o caminho

  • É seguido imediatamente por / ou por um separador específico da plataforma. No Windows, ~/ e ~\ ambos 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 de variáveis de HOMEDRIVE HOMEPATH ambiente () $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 de 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:

  • Arquivo de variável de ambiente config: AWS_CONFIG_FILE

  • Arquivo de variável de ambiente credentials: 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 como configurar seu sistema usando variáveis de ambiente, consulteSuporte a variáveis de ambiente.

Use as propriedades do sistema JVM

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

  • configpropriedade do sistema JVM do arquivo: aws.configFile

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

Para obter instruções sobre como definir as propriedades do sistema JVM, consulte. Como definir as propriedades do sistema JVM O SDK for Java 1.x não oferece suporte a essas propriedades do sistema.