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

O AWS SDK for Java 1.x entrou no modo de manutenção em 31 de julho de 2024 e chegará end-of-supportem 31 de dezembro de 2025. Recomendamos que você migre para o AWS SDK for Java 2.xpara 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

Para desenvolver com sucesso aplicativos que acessem Serviços da AWS usando o AWS SDK for 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 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 no Guia de referência de ferramentas AWS SDKs e ferramentas. Não siga a Etapa 2 porque a AWS SDK for 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, 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 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 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.

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

  5. Siga essas instruções no título Atualização manual de credenciais 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 PowerUserAccessou Desenvolvedor.

    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

A AWS SDK for 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 usar 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 for Java.

AWS SDK for 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.