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 identidade externo que funciona independentemente do IAM Identity Center, descubra como você pode obter credenciais temporárias SDK para uso do Java. Siga estas instruções para adicionar credenciais temporárias ao arquivo ~/.aws/credentials.

Se seu provedor de identidade adicionar credenciais temporárias automaticamente ao ~/.aws/credentials arquivo, 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ê entra manualmente no IAM Identity Center. O formato do URL é d-xxxxxxxxxx.awsapps.com/start ouyour_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 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 1.x não oferece suporte à atualização automática de tokens e à recuperação automática de credenciais temporárias para as 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 all AWS SDKs e pelo AWS Command Line Interface (CLI). Os arquivos de configuração compartilhados podem conter várias configurações, mas essas instruções configuram os elementos básicos necessários para trabalhar com SDK o.

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.

Configure credenciais temporárias para o SDK

Depois de ter acesso a uma IAM função Conta da AWS and por meio do portal de AWS acesso, configure seu ambiente de desenvolvimento com credenciais temporárias SDK para acesso.

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 for Java usa se um perfil nomeado específico não for especificado.

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

  5. Siga estas instruções no título Atualização manual de credenciais para copiar as credenciais da IAM função do AWS portal de acesso.

    1. Para a etapa 4 nas instruções vinculadas, escolha o nome da IAM função que concede acesso às 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 for Java acessará essas credenciais temporárias ao criar um cliente de serviço e usá-las para cada solicitação. As configurações da IAM função escolhida 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. Se você usa a versão 1.12.767 ou anterior doSDK, você pode usar o Java 7, mas se você usar a versão 1.12.768 ou mais recente do, o Java 8 é necessário. SDK O repositório central do Maven lista a versão mais recente do SDK para 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 JDK Open e Adoptium.