AWS SDK para Java

O AWS SDK para Java permite que desenvolvedores Java trabalhem facilmente com [Amazon Web Services][aws] e construam soluções escaláveis com Amazon S3, Amazon DynamoDB, Amazon Glacier e muito mais.

Consulte o [AWS SDK para Java 2.x][aws-sdk-for-java-2x] para saber como começar.

Em Modo de Manutenção a partir de 31 de julho de 2024

[O AWS SDK para Java 1.x está em modo de manutenção][maintenance-mode-post]. O AWS SDK para Java 1.x entrou em modo de manutenção em 31 de julho de 2024 e atingirá o fim do suporte em 31 de dezembro de 2025. Durante o modo de manutenção, a AWS limitará os lançamentos do SDK para corrigir apenas bugs críticos e problemas de segurança. O SDK não receberá atualizações de API para serviços novos ou existentes, nem será atualizado para suportar novas regiões.

Recomendamos que você [migre para o AWS SDK para Java 2.x][migration-guide]. O AWS SDK para Java 2.x oferece recursos aprimorados, melhor desempenho e suporte contínuo da AWS. Ao adotar a última versão do SDK, os desenvolvedores podem garantir a segurança, compatibilidade e estabilidade de suas soluções na AWS. A atualização também permite aproveitar os serviços e inovações mais recentes da AWS.

Fim do Suporte em 31 de dezembro de 2025

[O AWS SDK para Java 1.x atingirá o fim do suporte em 31 de dezembro de 2025][deprecation-announcement-post]. Após o fim do suporte, a AWS não receberá mais atualizações ou lançamentos. As versões publicadas anteriormente continuarão disponíveis por meio de gerenciadores de pacotes públicos e o código permanecerá no GitHub.

Notas de Lançamento

As alterações no SDK a partir da versão 1.12.1 (junho de 2021) são rastreadas em [CHANGELOG.md][changes-file].

As alterações na série aposentada 1.11.x do SDK, a partir da versão 1.11.82, estão listadas no arquivo CHANGELOG-1.11.x.md.

Primeiros Passos com a AWS

Use [o AWS SDK para Java 2.x para começar][sdk-v2-getting-started].

Usando o AWS SDK para Java 1.x

O AWS SDK para Java 1.x está em [modo de manutenção][maintenance-mode-post], então recomendamos que você use o [AWS SDK para Java 2.x][aws-sdk-for-java-2x].

Requisitos Mínimos

Para executar o AWS SDK para Java 1.x, você precisará do Java 1.8+. Para mais informações sobre os requisitos e configurações ideais para o SDK, consulte a seção [Instalando um Ambiente de Desenvolvimento Java][docs-java-env] do guia do desenvolvedor.

Instale o SDK 1.x

Você pode usar o AWS SDK para Java 1.x em seu projeto consumindo-o do Maven. Importe o [aws-java-sdk-bom][] e especifique os módulos Maven do SDK que seu projeto precisa nas dependências.

Importando o BOM 1.x

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>
      <version>1.12.788</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Usando os módulos Maven do SDK 1.x

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-ec2</artifactId>
  </dependency>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
  </dependency>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-dynamodb</artifactId>
  </dependency>
</dependencies>

Consulte a seção [Configurar o AWS SDK para Java 1.x][docs-setup] do guia do desenvolvedor para mais informações sobre como instalar o SDK 1.x por outros meios.

Compilando a partir do Código Fonte

Depois de obter o código do GitHub, você pode compilá-lo usando o Maven. Para desabilitar a assinatura GPG na compilação, use:

mvn clean install -Dgpg.skip=true

Obtendo Ajuda

O [issues][sdk-issues] do GitHub é o canal preferido para interagir com nossa equipe. Confira também estes recursos da comunidade para obter ajuda:

• Faça uma pergunta no [StackOverflow][stack-overflow] e marque-a com aws-java-sdk
• Expresse sua solicitação de recurso ou vote nas existentes em nossa página de [Issues][features]
• Dê uma olhada no [blog] para muitos tutoriais e dicas úteis
• Abra um caso através do [Centro de Suporte AWS][support-center] no [console AWS][console]
• Se você achar que encontrou um bug, abra um [issue][sdk-issues]

Manutenção e Suporte para Versões Principais do SDK

Para informações sobre manutenção e suporte para versões principais do SDK e suas dependências subjacentes, consulte o seguinte no Guia de Referência de SDKs e Ferramentas da AWS:

• [Política de Manutenção de SDKs e Ferramentas da AWS][maintenance-policy]
• [Matriz de Suporte de Versões de SDKs e Ferramentas da AWS][version-matrix]

Versões Menores Suportadas

• 1.12.x - Em [modo de manutenção][maintenance-mode-post]. Recomendamos migrar para o [AWS SDK para Java 2.x][aws-sdk-for-java-2x].

• 1.11.x - Não é mais suportado, mas a migração para 1.12.x não deve exigir alterações de código.

AWS SDK para Java 2.x

Uma versão 2.x do SDK está geralmente disponível. É uma reescrita importante da base de código 1.x, construída sobre o Java 8+ e adiciona vários recursos frequentemente solicitados. Estes incluem suporte para I/O não bloqueante, desempenho de inicialização melhorado, iteração automática sobre respostas paginadas e a capacidade de conectar uma implementação HTTP diferente em tempo de execução.

Para mais informações, consulte o [Guia do Desenvolvedor do AWS SDK para Java 2.x][sdk-v2-dev-guide] ou verifique o repositório do projeto em https://github.com/aws/aws-sdk-java-v2.

Manutenção e Suporte para Versões do Java

O AWS SDK para Java 1.x suporta versões Java de 8 a 17, mas pode não ser atualizado para suportar versões futuras do Java. Para garantir compatibilidade de longo prazo com as versões mais recentes do JDK, recomendamos que você migre para o [AWS SDK para Java 2.x][aws-sdk-for-java-2x].