Configuração básica para trabalhar com os Serviços da AWS - AWS SDK para Java 1.x
Visão geralCapacidade de efetuar login no portal de acesso da AWSDefinir arquivos de configuração compartilhadosInstalar um ambiente de desenvolvimento Java

O AWS SDK para Java 1.x entrou no modo de manutenção em 31 de julho de 2024 e o fim do suporte está previsto para 31 de dezembro de 2025. Recomendamos que você migre para o AWS SDK for Java 2.x para continuar recebendo novos recursos, melhorias de disponibilidade e atualizações de segurança.

Configuração básica para trabalhar com os Serviços da AWS

Visão geral

Para desenvolver com êxito aplicativos que acessem os Serviços da AWS usando o AWS SDK para Java, as seguintes condições são necessárias:

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 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 efetuar login no portal de acesso da AWS

O portal de acesso da AWS é 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 acesso da AWS, siga as orientações para acesso à conta na Etapa 1 do tópico de autenticação do IAM Identity Center no Guia de referência de SDKs e ferramentas da AWS. Não siga a Etapa 2 porque o AWS SDK para Java 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 os SDKs da AWS e pela AWS Command Line Interface (CLI). Os arquivos de configuração compartilhados podem conter várias configurações, 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 a Região da AWS mais próxima de onde você planeja executar seu código. Para obter uma lista dos códigos de região 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.

Siga as orientações nesta seção para criar o arquivo config.

Configurar credenciais temporárias para o SDK

Depois de ter acesso a uma Conta da AWS e a um perfil do IAM por meio do portal de acesso da AWS, 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.

  2. 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=<value from AWS access portal>
aws_secret_access_key=<value from AWS access portal>
aws_session_token=<value from AWS access portal>

  3. Salve o arquivo. Agora, o arquivo ~/.aws/credentials deve existir em seu sistema de desenvolvimento local. Esse arquivo contém o perfil [padrão] que o SDK para Java usa se um perfil nomeado específico não for especificado.

  4. Faça login no portal de acesso da AWS.

  5. Siga estas instruções no título Atualizar credencial manual para copiar credenciais do perfil do IAM do portal de acesso AWS.

    1. Na etapa 4 das instruções vinculadas, escolha o nome do perfil do IAM que concede acesso para suas necessidades de desenvolvimento. Esse perfil normalmente tem um nome como PowerUserAccess ou Developer.

    2. Na etapa 7, selecione a opção Adicionar manualmente um perfil ao seu arquivo de credenciais da AWS e copie o conteúdo.

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

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

O 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 compatíveis. 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 lista a versão mais recente do SDK para Java.

O AWS SDK para Java funciona com o Oracle Java SE Development Kit e com distribuições do Open Java Development Kit (OpenJDK), como Amazon Corretto, Red Hat OpenJDK e Adoptium.