

O AWS SDK para Java 1.x chegou end-of-support em 31 de dezembro de 2025. Recomendamos que você migre para o [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html) para continuar recebendo novos recursos, melhorias de disponibilidade e atualizações de segurança.

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

# Configure credenciais AWS temporárias e Região da AWS para desenvolvimento
<a name="setup-credentials"></a>

Para se conectar a qualquer um dos serviços compatíveis com o AWS SDK para Java, você deve fornecer credenciais AWS temporárias. O AWS SDKs e CLIs usa *cadeias de provedores* para procurar credenciais AWS temporárias em vários lugares diferentes, incluindo variáveis de system/user ambiente e arquivos de AWS configuração locais.

Este tópico fornece informações básicas sobre como configurar suas credenciais AWS temporárias para o desenvolvimento de aplicativos locais usando o. AWS SDK para Java Se for necessário configurar credenciais a serem usadas dentro de uma instância do EC2 ou se estiver usando o IDE do Eclipse para desenvolvimento, consulte os seguintes tópicos:
+ Ao usar uma instância do EC2, crie uma função do IAM e, em seguida, conceda à sua instância do EC2 acesso a essa função, conforme mostrado em [Usando funções do IAM para conceder acesso a AWS recursos](java-dg-roles.md) em. Amazon EC2
+ Configure AWS as credenciais no Eclipse usando o. [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/) Consulte [Configurar AWS credenciais](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/setup-credentials.html) no [Guia do AWS Toolkit for Eclipse usuário](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/) para obter mais informações.

## Configurar credenciais temporárias
<a name="setup-credentials-setting"></a>

Você pode configurar credenciais temporárias para o AWS SDK para Java de várias maneiras, mas aqui estão as abordagens recomendadas:
+ Defina credenciais temporárias no arquivo de perfil de AWS credenciais em seu sistema local, localizado em:
  +  `~/.aws/credentials` no Linux, macOS ou Unix
  +  `C:\Users\USERNAME\.aws\credentials` no Windows

  Consulte [Configurar credenciais temporárias para o SDK](signup-create-iam-user.md#setup-temp-creds) neste guia para obter instruções sobre como obter suas credenciais temporárias.
+ Defina as variáveis de ambiente `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` e `AWS_SESSION_TOKEN`.

  Para definir essas variáveis no Linux, macOS ou Unix, use :

  ```
  export AWS_ACCESS_KEY_ID=your_access_key_id
  export AWS_SECRET_ACCESS_KEY=your_secret_access_key
  export AWS_SESSION_TOKEN=your_session_token
  ```

  Para definir essas variáveis no Windows, use :

  ```
  set AWS_ACCESS_KEY_ID=your_access_key_id
  set AWS_SECRET_ACCESS_KEY=your_secret_access_key
  set AWS_SESSION_TOKEN=your_session_token
  ```
+ Para uma instância do EC2, especifique um perfil do IAM e dê à instância do EC2 acesso a essa função. Consulte [Funções do IAM Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html) no Guia Amazon EC2 do usuário para instâncias Linux para uma discussão detalhada sobre como isso funciona.

Depois de definir suas credenciais AWS temporárias usando um desses métodos, elas serão carregadas automaticamente AWS SDK para Java pelo usando a cadeia de fornecedores de credenciais padrão. Para obter mais informações sobre como trabalhar com AWS credenciais em seus aplicativos Java, consulte [Trabalhando com AWS credenciais](credentials.md).

## Atualizar credenciais do IMDS
<a name="refresh-credentials"></a>

 AWS SDK para Java Ele suporta a atualização opcional das credenciais do IMDS em segundo plano a cada 1 minuto, independentemente do tempo de expiração da credencial. Isso permite que você atualize as credenciais com mais frequência e reduz a chance de que a falta de acesso ao IMDS afete a disponibilidade percebida. AWS 

```
 1. // Refresh credentials using a background thread, automatically every minute. This will log an error if IMDS is down during
 2. // a refresh, but your service calls will continue using the cached credentials until the credentials are refreshed
 3. // again one minute later.
 4.
 5. InstanceProfileCredentialsProvider credentials =
 6.     InstanceProfileCredentialsProvider.createAsyncRefreshingProvider(true);
 7.
 8. AmazonS3Client.builder()
 9.              .withCredentials(credentials)
 10.              .build();
 11.
 12. // This is new: When you are done with the credentials provider, you must close it to release the background thread.
 13. credentials.close();
```

## Defina o Região da AWS
<a name="setup-credentials-setting-region"></a>

Você deve definir um padrão Região da AWS que será usado para acessar AWS serviços com AWS SDK para Java o. Tendo em vista o melhor desempenho da rede, você deve escolher uma região geograficamente próxima de você (ou dos clientes). Para obter uma lista de regiões para cada serviço, consulte [Regiões e endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html) na Referência Amazon Web Services geral.

**nota**  
Se você *não* selecionar uma região, us-east-1 será usada por padrão.

Você pode usar técnicas semelhantes à configuração de credenciais para definir sua AWS região padrão:
+ Defina o Região da AWS no arquivo de AWS configuração em seu sistema local, localizado em:
  + \$1/.aws/config no Linux, macOS ou Unix
  + C:\$1Users\$1USERNAME\$1.aws\$1config no Windows

  Esse arquivo deve conter linhas no seguinte formato:

  \$1

  ```
  [default]
  region = your_aws_region
  ```

  \$1

  *Substitua sua região desejada Região da AWS (por exemplo, “us-east-1") por your\$1aws\$1region.*
+ Defina a variável de ambiente `AWS_REGION`.

  No Linux, macOS ou Unix, use **``**:

  ```
  export AWS_REGION=your_aws_region
  ```

  No Windows, use ** `` **:

  ```
  set AWS_REGION=your_aws_region
  ```

  Onde *your\$1aws\$1region* é o nome desejado. Região da AWS 