O AWS SDK para Java 1.x atingiu o fim do suporte 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á.
# Amostras de código incluídas no SDK
O AWS SDK para Java acompanha exemplos de código que demonstram muitos dos recursos do SDK nos programas executáveis, compiláveis. Você pode estudar ou modificá-los para implementar as próprias soluções da AWS usando o AWS SDK para Java.
## Como obter os exemplos
Os exemplos de código do AWS SDK para Java são fornecidos no diretório de *exemplos* do SDK. Se tiver obtido por download e instalado o SDK usando as informações em [Configurar o AWS SDK para Java](setup-install.md), você já terá os exemplos no sistema.
Você também pode visualizar os exemplos mais recentes no repositório GitHub do AWS SDK para Java, no diretório [src/samples](https://github.com/aws/aws-sdk-java/tree/master/src/samples).
## Compilar e executar os exemplos usando a linha de comando
Entre os exemplos estão scripts de compilação [Ant](http://ant.apache.org/), de maneira que você possa compilar e executá-los facilmente na linha de comando. Todo exemplo também contém um arquivo README em formato HTML com informações específicas de cada exemplo.
**nota**
Se você estiver procurando o código de exemplo no GitHub, clique no botão **Raw** na exibição do código-fonte ao visualizar o arquivo README.html do exemplo. Em modo bruto, o HTML será renderizado conforme desejado no navegador.
### Pré-requisitos
Para executar qualquer um dos exemplos do AWS SDK para Java, você precisa definir as credenciais da AWS no ambiente ou com a AWS CLI, conforme especificado em [Configurar credenciais e região da AWS para desenvolvimento](setup-credentials.md). Os exemplos usam a cadeia de fornecedores de credencial padrão sempre que possível. Dessa forma, definindo as credenciais assim, você pode evitar a prática arriscada de inserir as credenciais da AWS em arquivos dentro do diretório de código-fonte (onde o check-in deles pode ser feito inadvertidamente, além de compartilhados publicamente).
### Executar os exemplos
1. Mude para o diretório que contém o código de exemplo. Por exemplo, se você está no diretório raiz do download do SDK da AWS e deseja executar o exemplo `AwsConsoleApp`, digite:
```
cd samples/AwsConsoleApp
```
1. Compile e execute o exemplo com Ant. O alvo da compilação padrão realiza ambas as ações. Dessa forma, basta você inserir:
```
ant
```
As informações de impressões de exemplo para a saída padrão, por exemplo:
```
===========================================
Welcome to the {AWS} Java SDK!
===========================================
You have access to 4 Availability Zones.
You have 0 {EC2} instance(s) running.
You have 13 Amazon SimpleDB domain(s) containing a total of 62 items.
You have 23 {S3} bucket(s), containing 44 objects with a total size of 154767691 bytes.
```
## Compilar e executar os exemplos usando o IDE do Eclipse
Se usar o AWS Toolkit for Eclipse, você também poderá iniciar um novo projeto no Eclipse com base no AWS SDK para Java ou adicionar o SDK a um projeto do Java existente.
### Pré-requisitos
Após a instalação do AWS Toolkit for Eclipse, recomendamos configurar o Toolkit com as credenciais de segurança. Você pode fazer isso a qualquer momento escolhendo **Preferências** no menu **Janela** do Eclipse e a seção **Kit de ferramentas da AWS**.
### Executar os exemplos
1. Abra o Eclipse.
1. Criar um novo projeto da AWS em Java. No Eclipse, no menu **File**, escolha **New** e clique em **Project**. O assistente **New Project** é aberto.
1. Expanda a categoria **AWS** e escolha **AWS Java Project**.
1. Escolha **Próximo**. A página de configurações do projeto é exibida.
1. Insira um nome na caixa **Project Name**. O grupo de exemplos do AWS SDK para Java exibe os exemplos disponíveis no SDK, conforme descrito anteriormente.
1. Selecione os exemplos que você deseja incluir no projeto marcando cada caixa de seleção.
1. Insira credenciais de usuário da AWS. Se você já configurou o AWS Toolkit for Eclipse com as credenciais, ele será preenchido automaticamente.
1. Escolha **Terminar**. O projeto é criado e adicionado ao **Project Explorer**.
1. Escolha o arquivo de exemplo `.java` que você deseja executar. Por exemplo, para o exemplo do Amazon S3, escolha `S3Sample.java`.
1. Escolha **Run** no menu **Run**.
1. Clique com o botão direito do mouse no projeto em **Project Explorer**, aponte para **Build Path** e escolha **Add Libraries**.
1. Escolha **AWS SDK para Java**, selecione **Avançar** e siga as instruções na tela restantes.