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á.
# Configuração básica para trabalhar Serviços da AWS
## Visão geral do
Para desenvolver com sucesso aplicativos que acessem Serviços da AWS usando o AWS SDK para Java, as seguintes condições são necessárias:
+ Você deve conseguir [entrar no portal de acesso da AWS](#setup-awsaccount) disponível em Centro de Identidade do AWS IAM.
+ As [permissões da função do IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) configurada para o SDK devem permitir o acesso ao Serviços da AWS que seu aplicativo exige. As permissões associadas à política **PowerUserAccess** AWS gerenciada são suficientes para a maioria das necessidades de desenvolvimento.
+ Um ambiente de desenvolvimento com os seguintes elementos:
+ [Arquivos de configuração compartilhados](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) que são configurados da seguinte forma:
+ O `config` arquivo contém um perfil padrão que especifica um Região da AWS.
+ O arquivo `credentials` contém credenciais temporárias como parte de um perfil padrão.
+ Uma [instalação do Java](#java-dg-java-env) adequada.
+ Uma [ferramenta de automação de compilação](setup-build-tools.md), como [Maven](https://maven.apache.org/download.cgi) ou [Gradle](https://gradle.org/install/).
+ Um editor de texto para trabalhar com código.
+ (Opcional, mas recomendado) Um IDE (ambiente de desenvolvimento integrado), como [IntelliJ IDEA](https://www.jetbrains.com/idea/download/#section=windows)[,](https://www.eclipse.org/ide/) Eclipse ou. [NetBeans](https://netbeans.org/downloads/)
Ao usar um IDE, você também pode integrar AWS Toolkit s para trabalhar com mais facilidade Serviços da AWS. O [AWS Toolkit para IntelliJ](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html) e o [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/welcome.html) são dois kits de ferramentas que você pode usar para desenvolvimento em Java.
**Importante**
As instruções nesta seção de configuração pressupõem que você ou a organização usam o IAM Identity Center. Se sua organização usa um provedor de identidades externo que funciona independentemente do IAM Identity Center, descubra como você pode obter credenciais temporárias para o SDK para Java usar. Siga [estas instruções](#setup-temp-creds) para adicionar credenciais temporárias ao arquivo `~/.aws/credentials`.
Se seu provedor de identidade adicionar credenciais temporárias automaticamente ao arquivo `~/.aws/credentials`, certifique-se de que o nome do perfil seja `[default]` para que você não precise fornecer um nome de perfil ao SDK ou à AWS CLI.
## Capacidade de login no portal de acesso AWS
O portal de AWS acesso é o local da web em que você faz login manualmente no IAM Identity Center. O formato da URL é `d-xxxxxxxxxx.awsapps.com/start` ou `your_subdomain.awsapps.com/start`.
Se você não estiver familiarizado com o portal de AWS acesso, siga as orientações para acesso à conta na [Etapa 1 do tópico de autenticação do IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted) no Guia de referência de ferramentas AWS SDKs e ferramentas. Não siga a Etapa 2 porque a AWS SDK para Java versão 1.x não oferece suporte à atualização automática de tokens e à recuperação automática de credenciais temporárias para o SDK que a Etapa 2 descreve.
## Definir arquivos de configuração compartilhados
Os arquivos de configuração compartilhados residem na sua estação de trabalho de desenvolvimento e contêm configurações básicas usadas por todos AWS SDKs e pela AWS Command Line Interface (CLI). Os arquivos de configuração compartilhados podem conter [várias configurações](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html), mas essas instruções definem os elementos básicos necessários para trabalhar com o SDK.
### Configurar o arquivo compartilhado `config`
O exemplo a seguir mostra o conteúdo de um arquivo compartilhado `config`.
```
[default]
region=us-east-1
output=json
```
Para fins de desenvolvimento, use o Região da AWS [mais próximo](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) de onde você planeja executar seu código. Para obter uma [lista dos códigos de região](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes) a serem usados no arquivo `config`, consulte o guia Referência geral da Amazon Web Services . A configuração `json` do formato de saída é um dos [vários valores possíveis](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html).
Siga as orientações [nesta seção](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) para criar o arquivo `config`.
### Configurar credenciais temporárias para o SDK
Depois de ter acesso a uma Conta da AWS função do IAM por meio do portal de AWS acesso, configure seu ambiente de desenvolvimento com credenciais temporárias para o SDK acessar.
**Etapas para configurar um arquivo local `credentials` com credenciais temporárias**
1. [Crie um arquivo compartilhado `credentials`](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html).
1. No arquivo de `credentials`, cole o texto do espaço reservado a seguir até colar as credenciais temporárias de trabalho.
```
[default]
aws_access_key_id=
aws_secret_access_key=
aws_session_token=
```
1. Salve o arquivo. Agora, o arquivo `~/.aws/credentials` deve existir em seu sistema de desenvolvimento local. Esse arquivo contém o [perfil [padrão]](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) que o SDK para Java usa se um perfil nomeado específico não for especificado.
1. [Faça login no portal de AWS acesso](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignin.html).
1. Siga essas instruções no título [Atualização manual de credenciais](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) para copiar as credenciais da função do IAM do AWS portal de acesso.
1. Na etapa 4 das instruções vinculadas, escolha o nome do perfil do IAM que concede acesso para suas necessidades de desenvolvimento. Essa função geralmente tem um nome como **PowerUserAccess**ou **Desenvolvedor**.
1. Na etapa 7, selecione a opção **Adicionar manualmente um perfil ao seu arquivo de credenciais da AWS ** e copie o conteúdo.
1. Cole as credenciais copiadas em seu arquivo local `credentials` e remova qualquer nome de perfil que tenha sido colado. Seu arquivo deve se parecer com o seguinte:
```
[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
1. Salve o arquivo `credentials`
O SDK para Java acessará essas credenciais temporárias quando cria um cliente de serviço e as usa para cada solicitação. As configurações do perfil do IAM escolhidas na etapa 5a determinam [por quanto tempo as credenciais temporárias são válidas](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html). A duração máxima é de doze horas.
Depois que as credenciais temporárias expirarem, repita as etapas de 4 a 7.
## Instalar um ambiente de desenvolvimento Java
A AWS SDK para Java V1 requer um Java 7 JDK ou mais recente e todas as versões do Java LTS (suporte de longo prazo) do JDK são suportadas. Se você usa a versão 1.12.767 ou anterior do SDK, pode usar o Java 7, mas se usa a versão 1.12.768 ou mais recente do SDK, o Java 8 é necessário. O [repositório central do Maven](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) lista a versão mais recente do SDK para Java.
AWS SDK para Java [https://developers.redhat.com/products/openjdk/overview](https://developers.redhat.com/products/openjdk/overview)