O AWS SDK para Java 1.x chegou end-of-support 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á. # Conceitos básicos Esta seção fornece informações sobre como instalar, configurar e usar o AWS SDK para Java. **Topics** + [Configuração básica](signup-create-iam-user.md) + [Maneiras de obter o AWS SDK para Java](setup-install.md) + [Usar ferramentas de compilação](setup-build-tools.md) + [Credenciais temporárias e região](setup-credentials.md) # Configuração básica para trabalhar Serviços da AWS ## Visão geral do Para desenvolver com sucesso aplicativos que acessem Serviços da AWS usando o AWS SDK para Java, as seguintes condições são necessárias: + Você deve conseguir [entrar no portal de acesso da AWS](#setup-awsaccount) disponível em Centro de Identidade do AWS IAM. + As [permissões da função do IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) configurada para o SDK devem permitir o acesso ao Serviços da AWS que seu aplicativo exige. As permissões associadas à política **PowerUserAccess** AWS gerenciada são suficientes para a maioria das necessidades de desenvolvimento. + Um ambiente de desenvolvimento com os seguintes elementos: + [Arquivos de configuração compartilhados](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) que são configurados da seguinte forma: + O `config` arquivo contém um perfil padrão que especifica um Região da AWS. + O arquivo `credentials` contém credenciais temporárias como parte de um perfil padrão. + Uma [instalação do Java](#java-dg-java-env) adequada. + Uma [ferramenta de automação de compilação](setup-build-tools.md), como [Maven](https://maven.apache.org/download.cgi) ou [Gradle](https://gradle.org/install/). + Um editor de texto para trabalhar com código. + (Opcional, mas recomendado) Um IDE (ambiente de desenvolvimento integrado), como [IntelliJ IDEA](https://www.jetbrains.com/idea/download/#section=windows)[,](https://www.eclipse.org/ide/) Eclipse ou. [NetBeans](https://netbeans.org/downloads/) Ao usar um IDE, você também pode integrar AWS Toolkit s para trabalhar com mais facilidade Serviços da AWS. O [AWS Toolkit para IntelliJ](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html) e o [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/welcome.html) são dois kits de ferramentas que você pode usar para desenvolvimento em Java. **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](#setup-temp-creds) 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](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted) no Guia de referência de ferramentas AWS SDKs e ferramentas. Não siga a Etapa 2 porque a AWS SDK para 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](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html), 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](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) de onde você planeja executar seu código. Para obter uma [lista dos códigos de região](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes) 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html). Siga as orientações [nesta seção](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) 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`](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html). 1. 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= aws_secret_access_key= aws_session_token= ``` 1. Salve o arquivo. Agora, o arquivo `~/.aws/credentials` deve existir em seu sistema de desenvolvimento local. Esse arquivo contém o [perfil [padrão]](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) que o SDK para Java usa se um perfil nomeado específico não for especificado. 1. [Faça login no portal de AWS acesso](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignin.html). 1. Siga essas instruções no título [Atualização manual de credenciais](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) 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 **PowerUserAccess**ou **Desenvolvedor**. 1. Na etapa 7, selecione a opção **Adicionar manualmente um perfil ao seu arquivo de credenciais da AWS ** e copie o conteúdo. 1. 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 ``` 1. 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](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html). 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 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 suportadas. 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](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) lista a versão mais recente do SDK para Java. AWS SDK para Java [https://developers.redhat.com/products/openjdk/overview](https://developers.redhat.com/products/openjdk/overview) # Maneiras de obter o AWS SDK para Java ## Pré-requisitos Para usar o AWS SDK para Java, você deve ter: + Você deve conseguir [entrar no portal de acesso da AWS](signup-create-iam-user.md#setup-awsaccount) disponível em Centro de Identidade do AWS IAM. + Uma [instalação do Java](signup-create-iam-user.md#java-dg-java-env) adequada. + Credenciais temporárias configuradas em seu arquivo compartilhado `credentials` local. Consulte o tópico [Configuração básica para trabalhar Serviços da AWS](signup-create-iam-user.md) para obter instruções sobre como se preparar para usar o SDK para Java. ## Usar uma ferramenta de compilação para gerenciar dependências do SDK para Java (recomendado) Recomendamos usar o Apache Maven ou o Gradle com seu projeto para acessar as dependências necessárias do SDK para Java.[ Esta seção](setup-build-tools.md) descreve como usar essas ferramentas. ## Baixar e extrair o SDK (não recomendado) Recomendamos que você use uma ferramenta de compilação para acessar o SDK do seu projeto. No entanto, você pode baixar um jar pré-compilado da versão mais recente do SDK. **nota** Para obter informações sobre como fazer download e compilar versões anteriores do SDK, consulte [Instalar versões anteriores do SDK](#install-prev-sdk). 1. Faça o download do SDK em [https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip.](https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip) 1. Depois de fazer download do SDK, extraia o conteúdo em um diretório local. O SDK contém os seguintes diretórios: + `documentation`: contém a documentação da API (também disponível na web: [Referência de API do AWS SDK para Java](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/)). + `lib`: contém os arquivos `.jar` do SDK. + `samples`: contém código de exemplo funcional que demonstra como usar o SDK. + `third-party/lib`: contém bibliotecas de terceiros usadas pelo SDK, como registro em log comum do Apache, AspectJ e a estrutura do Spring. Para usar o SDK, adicione o caminho completo dos diretórios `lib` e `third-party` às dependências no arquivo de compilação e os adicione ao `CLASSPATH` Java para executar o código. ## Compilar versões anteriores do SDK a partir da fonte (não recomendado) Somente a versão mais recente do SDK completo é fornecida na forma pré-compilada como jar disponível para download. No entanto, você pode compilar uma versão anterior do SDK usando o Apache Maven (código-fonte aberto). O Maven vai fazer download de todas as dependências necessárias, compilar e instalar o SDK em uma única etapa. Visite [http://maven.apache.org/](http://maven.apache.org/) para obter instruções de instalação e mais informações. 1. Acesse a GitHub página do SDK em: [AWS SDK para Java (GitHub)](https://github.com/aws/aws-sdk-java). 1. Escolha a tag correspondente ao número de versão do SDK desejada. Por exemplo, .`1.6.10` 1. Clique no botão **Download ZIP** para fazer download da versão do SDK selecionada por você. 1. Descompacte o arquivo em um diretório no sistema de desenvolvimento. Em muitos sistemas, você pode usar o gerenciador de arquivos gráficos para fazer isso ou usar o utilitário `unzip` em uma janela de terminal. 1. Em uma janela de terminal, navegue até o diretório em que você descompactou o código-fonte do SDK. 1. Compile e instale o SDK com o seguinte comando ([Maven](https://maven.apache.org/) obrigatório): ``` mvn clean install -Dgpg.skip=true ``` O arquivo `.jar` resultante foi compilado no diretório `target`. 1. (Opcional) Compile a documentação de referência da API usando o seguinte comando: ``` mvn javadoc:javadoc ``` A documentação foi compilada no diretório `target/site/apidocs/`. # Usar ferramentas de compilação O uso de ferramentas de compilação ajuda a gerenciar o desenvolvimento de projetos Java. Várias ferramentas de compilação estão disponíveis, mas mostramos como começar a usar duas ferramentas de compilação populares: Maven e Gradle. Este tópico mostra como usar essas ferramentas de compilação para gerenciar as dependências do SDK para Java necessárias para seus projetos. **Topics** + [Usar o SDK com o Apache Maven](setup-project-maven.md) + [Usar o SDK com o Gradle](setup-project-gradle.md) # Usar o SDK com o Apache Maven Você pode usar o [Apache Maven](https://maven.apache.org/) para configurar e compilar projetos do AWS SDK para Java ou compilar o próprio SDK. **nota** Você deve ter o Maven instalado para usar a diretriz deste tópico. Se ele ainda não estiver instalado, visite [http://maven.apache.org/](http://maven.apache.org/) para fazer download e instalá-lo. ## Criar um novo pacote do Maven Para criar um pacote do Maven básico, abra uma janela de terminal (linha de comando) e execute: ``` mvn -B archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DgroupId=org.example.basicapp \ -DartifactId=myapp ``` Substitua *org.example.basicapp* pelo namespace do pacote completo do aplicativo e *myapp* pelo nome do projeto (este será o nome do diretório do projeto). Por padrão, cria um modelo de projeto para você usando o arquétipo [quickstart](http://maven.apache.org/archetypes/maven-archetype-quickstart/), que é um bom ponto de partida para muitos projetos. Existem mais arquétipos disponíveis; visite a página [Arquétipos do Maven](https://maven.apache.org/archetypes/index.html) para obter uma lista de arquétipos empacotados. Você pode escolher um determinado arquétipo a ser usado adicionando o argumento `-DarchetypeArtifactId` ao comando `archetype:generate`. Por exemplo: ``` mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DgroupId=org.example.webapp \ -DartifactId=mywebapp ``` **nota** Muito mais informações sobre como criar e configurar projetos são fornecidas no [Guia de conceitos básicos do Maven](https://maven.apache.org/guides/getting-started/). ## Configurar o SDK como uma dependência do Maven Para usar o AWS SDK para Java no projeto, será necessário declará-lo como uma dependência no arquivo `pom.xml` do projeto. Desde a versão 1.9.0, você pode importar [componentes individuais](#configuring-maven-individual-components) ou [todo o SDK](#configuring-maven-entire-sdk). ### Especificar módulos de SDK individuais Para selecionar módulos de SDK individuais, use a lista de materiais (BOM) do AWS SDK para Java para Maven, o que garantirá que os módulos especificados usem a mesma versão do SDK e sejam compatíveis entre si. Para usar a BOM, adicione uma seção `` ao arquivo `pom.xml` do aplicativo, adicionando `aws-java-sdk-bom` como uma dependência e especificando a versão do SDK que você deseja usar: ``` com.amazonaws aws-java-sdk-bom 1.11.1000 pom import ``` Para visualizar a versão mais recente da BOM do AWS SDK para Java disponível no Maven Central, visite: [https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom). Também é possível usar essa página para ver quais módulos (dependências) são gerenciados pela BOM que é possível incluir na seção `` do arquivo `pom.xml` do projeto. Agora você pode selecionar módulos individuais do SDK usados no aplicativo. Como já declarou a versão do SDK na BOM, você não precisa especificar o número da versão de cada componente. ``` com.amazonaws aws-java-sdk-s3 com.amazonaws aws-java-sdk-dynamodb ``` Também é possível consultar o *Catálogo de exemplos de código da AWS* para saber quais dependências devem ser usadas para determinado AWS service (Serviço da AWS). Consulte o arquivo POM em um exemplo de serviço específico. Por exemplo, se você estiver interessado nas dependências do serviço do AWS S3, consulte o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/s3/src/main/java/aws/example/s3/GetAcl.java) no GitHub. (Examine o pom em /java/example\$1code/s3). ### Importar todos os módulos do SDK Se você quiser extrair *todo* o SDK como uma dependência, não use o método da BOM. Basta declará-lo no `pom.xml` da seguinte forma: ``` com.amazonaws aws-java-sdk 1.11.1000 ``` ## Compilar o projeto Depois de configurar o projeto, será possível criá-lo usando o comando `package` do Maven: ``` mvn package ``` Isso criará o arquivo `–0—jar` no diretório `target`. ## Compilar o SDK com o Maven Você pode usar o Apache Maven para compilar o SDK pela origem. Para isso, [faça download do código do SDK no GitHub](https://github.com/aws/aws-sdk-java), descompacte-o localmente e execute o seguinte comando do Maven: ``` mvn clean install ``` # Usar o SDK com o Gradle Para gerenciar as dependências do SDK do seu projeto [Gradle](https://gradle.com/), importe o BOM do Maven AWS SDK para Java para o arquivo do aplicativo. `build.gradle` **nota** Nos exemplos a seguir, *1.12.529* substitua o arquivo de compilação por uma versão válida do AWS SDK para Java. Encontre a versão mais recente no [repositório central do Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Configuração do projeto para Gradle 4.6 ou superior [Desde o Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import), é possível usar o recurso de suporte de POM aprimorado do Gradle para a importação de arquivos de lista de materiais (BOM) declarando uma dependência em uma BOM. 1. Se você estiver usando o Gradle 5.0 ou posterior, pule para a etapa 2. Caso contrário, habilite o recurso *IMPROVED\$1POM\$1SUPPORT* no arquivo `settings.gradle`. ``` enableFeaturePreview('IMPROVED_POM_SUPPORT') ``` 1. Adicione a BOM à seção *dependências* do arquivo `build.gradle` do aplicativo. ``` ... dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') // Declare individual SDK dependencies without version ... } ``` 1. Especifique os módulos do SDK a serem usados na seção *dependencies*. Por exemplo, o seguinte inclui uma dependência para Amazon Simple Storage Service (Amazon S3). ``` ... dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') implementation 'com.amazonaws:aws-java-sdk-s3' ... } ``` O Gradle resolve automaticamente a versão correta das dependências do SDK usando as informações da BOM. Veja a seguir um exemplo de um `build.gradle` arquivo completo que inclui uma dependência para Amazon S3. ``` group 'aws.test' version '1.0-SNAPSHOT' apply plugin: 'java' sourceCompatibility = 1.8 repositories { mavenCentral() } dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') implementation 'com.amazonaws:aws-java-sdk-s3' } ``` **nota** No exemplo anterior, substitua a dependência por pelas Amazon S3 dependências dos AWS serviços que você usará em seu projeto. Os módulos (dependências) que são gerenciados pelo AWS SDK para Java BOM estão listados no repositório [central do Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Configuração do projeto para versões do Gradle anteriores à 4.6 As versões do Gradle anteriores à 4.6 não possuem suporte nativo a BOM. Para gerenciar AWS SDK para Java dependências do seu projeto, use o [plug-in de gerenciamento de dependências](https://github.com/spring-gradle-plugins/dependency-management-plugin) do Spring para Gradle para importar o BOM do Maven para o SDK. 1. Adicione o plug-in de gerenciamento de dependências ao arquivo `build.gradle` do aplicativo. ``` buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE" } } apply plugin: "io.spring.dependency-management" ``` 1. Adicione a BOM à seção *dependencyManagement* do arquivo. ``` dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529' } } ``` 1. Especifique os módulos do SDK que você usará na seção *dependencies* Por exemplo, o seguinte inclui uma dependência para o Amazon S3. ``` dependencies { compile 'com.amazonaws:aws-java-sdk-s3' } ``` O Gradle resolve automaticamente a versão correta das dependências do SDK usando as informações da BOM. Veja a seguir um exemplo de um `build.gradle` arquivo completo que inclui uma dependência para Amazon S3. ``` group 'aws.test' version '1.0' apply plugin: 'java' sourceCompatibility = 1.8 repositories { mavenCentral() } buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE" } } apply plugin: "io.spring.dependency-management" dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529' } } dependencies { compile 'com.amazonaws:aws-java-sdk-s3' testCompile group: 'junit', name: 'junit', version: '4.11' } ``` **nota** No exemplo anterior, substitua a dependência por pelas Amazon S3 dependências do AWS serviço que você usará em seu projeto. Os módulos (dependências) que são gerenciados pelo AWS SDK para Java BOM estão listados no repositório [central do Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). Para obter mais informações sobre como especificar dependências do SDK usando a BOM, consulte [Usar o SDK com o Apache Maven](setup-project-maven.md). # Configure credenciais AWS temporárias e Região da AWS para desenvolvimento Para se conectar a qualquer um dos serviços compatíveis com o AWS SDK para Java, você deve fornecer credenciais AWS temporárias. O AWS SDKs e CLIs usa *cadeias de provedores* para procurar credenciais AWS temporárias em vários lugares diferentes, incluindo variáveis de system/user ambiente e arquivos de AWS configuração locais. Este tópico fornece informações básicas sobre como configurar suas credenciais AWS temporárias para o desenvolvimento de aplicativos locais usando o. AWS SDK para Java Se for necessário configurar credenciais a serem usadas dentro de uma instância do EC2 ou se estiver usando o IDE do Eclipse para desenvolvimento, consulte os seguintes tópicos: + Ao usar uma instância do EC2, crie uma função do IAM e, em seguida, conceda à sua instância do EC2 acesso a essa função, conforme mostrado em [Usando funções do IAM para conceder acesso a AWS recursos](java-dg-roles.md) em. Amazon EC2 + Configure AWS as credenciais no Eclipse usando o. [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/) Consulte [Configurar AWS credenciais](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/setup-credentials.html) no [Guia do AWS Toolkit for Eclipse usuário](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/) para obter mais informações. ## Configurar credenciais temporárias Você pode configurar credenciais temporárias para o AWS SDK para Java de várias maneiras, mas aqui estão as abordagens recomendadas: + Defina credenciais temporárias no arquivo de perfil de AWS credenciais em seu sistema local, localizado em: + `~/.aws/credentials` no Linux, macOS ou Unix + `C:\Users\USERNAME\.aws\credentials` no Windows Consulte [Configurar credenciais temporárias para o SDK](signup-create-iam-user.md#setup-temp-creds) neste guia para obter instruções sobre como obter suas credenciais temporárias. + Defina as variáveis de ambiente `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` e `AWS_SESSION_TOKEN`. Para definir essas variáveis no Linux, macOS ou Unix, use : ``` export AWS_ACCESS_KEY_ID=your_access_key_id export AWS_SECRET_ACCESS_KEY=your_secret_access_key export AWS_SESSION_TOKEN=your_session_token ``` Para definir essas variáveis no Windows, use : ``` set AWS_ACCESS_KEY_ID=your_access_key_id set AWS_SECRET_ACCESS_KEY=your_secret_access_key set AWS_SESSION_TOKEN=your_session_token ``` + Para uma instância do EC2, especifique um perfil do IAM e dê à instância do EC2 acesso a essa função. Consulte [Funções do IAM Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html) no Guia Amazon EC2 do usuário para instâncias Linux para uma discussão detalhada sobre como isso funciona. Depois de definir suas credenciais AWS temporárias usando um desses métodos, elas serão carregadas automaticamente AWS SDK para Java pelo usando a cadeia de fornecedores de credenciais padrão. Para obter mais informações sobre como trabalhar com AWS credenciais em seus aplicativos Java, consulte [Trabalhando com AWS credenciais](credentials.md). ## Atualizar credenciais do IMDS AWS SDK para Java Ele suporta a atualização opcional das credenciais do IMDS em segundo plano a cada 1 minuto, independentemente do tempo de expiração da credencial. Isso permite que você atualize as credenciais com mais frequência e reduz a chance de que a falta de acesso ao IMDS afete a disponibilidade percebida. AWS ``` 1. // Refresh credentials using a background thread, automatically every minute. This will log an error if IMDS is down during 2. // a refresh, but your service calls will continue using the cached credentials until the credentials are refreshed 3. // again one minute later. 4. 5. InstanceProfileCredentialsProvider credentials = 6. InstanceProfileCredentialsProvider.createAsyncRefreshingProvider(true); 7. 8. AmazonS3Client.builder() 9. .withCredentials(credentials) 10. .build(); 11. 12. // This is new: When you are done with the credentials provider, you must close it to release the background thread. 13. credentials.close(); ``` ## Defina o Região da AWS Você deve definir um padrão Região da AWS que será usado para acessar AWS serviços com AWS SDK para Java o. Tendo em vista o melhor desempenho da rede, você deve escolher uma região geograficamente próxima de você (ou dos clientes). Para obter uma lista de regiões para cada serviço, consulte [Regiões e endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html) na Referência Amazon Web Services geral. **nota** Se você *não* selecionar uma região, us-east-1 será usada por padrão. Você pode usar técnicas semelhantes à configuração de credenciais para definir sua AWS região padrão: + Defina o Região da AWS no arquivo de AWS configuração em seu sistema local, localizado em: + \$1/.aws/config no Linux, macOS ou Unix + C:\$1Users\$1USERNAME\$1.aws\$1config no Windows Esse arquivo deve conter linhas no seguinte formato: \$1 ``` [default] region = your_aws_region ``` \$1 *Substitua sua região desejada Região da AWS (por exemplo, “us-east-1") por your\$1aws\$1region.* + Defina a variável de ambiente `AWS_REGION`. No Linux, macOS ou Unix, use **``**: ``` export AWS_REGION=your_aws_region ``` No Windows, use ** `` **: ``` set AWS_REGION=your_aws_region ``` Onde *your\$1aws\$1region* é o nome desejado. Região da AWS