要使用的基本设置 AWS 服务 - AWS SDK for Java 1.x
概览AWS 访问门户的登录能力设置共享配置文件安装 Java 开发环境

自2024年7月31日起， AWS SDK for Java 1.x已进入维护模式，并将于2025年12月31日end-of-support上线。我们建议您迁移到AWS SDK for Java 2.x以继续接收新功能、可用性改进和安全更新。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

要使用的基本设置 AWS 服务

概览

要成功开发 AWS 服务 使用访问的应用程序 AWS SDK for Java，需要满足以下条件：

重要

本设置部分中的说明假设您或组织使用 IAM Identity Center。如果您的组织使用独立于 IAM Identity Center 运行的外部身份提供商，请了解如何获取临时凭证以供适用于 Java 的 SDK 使用。按照以下说明向 ~/.aws/credentials 文件添加临时凭证。

如果您的身份提供商自动向 ~/.aws/credentials 文件添加临时凭证，请确保配置文件名称为 [default]，这样您就无需向 SDK 或 AWS CLI提供配置文件名称。

AWS 访问门户的登录能力

AWS 访问门户是您手动登录 IAM 身份中心的网址。URL 的格式为 d-xxxxxxxxxx.awsapps.com/start 或 your_subdomain.awsapps.com/start。

如果您不熟悉 AWS 访问门户，请按照 AWS SDKs 和工具参考指南中 IAM Identity Center 身份验证主题步骤 1 中的账户访问指南进行操作。请勿执行步骤 2，因为 AWS SDK for Java 1.x 不支持步骤 2 所描述的 SDK 的自动令牌刷新和自动检索临时证书。

设置共享配置文件

共享的配置文件位于您的开发工作站上，包含所有 AWS SDKs 和 AWS Command Line Interface (CLI) 使用的基本设置。共享配置文件可以包含许多设置，但本说明用于设置使用 SDK 所需的基本元素。

设置共享 config 文件

以下示例展示了共享 config 文件的内容。

[default]
region=us-east-1
output=json

出于开发目的，请使用离你计划运行代码的地方 AWS 区域 最近的。有关可在 config 文件中使用的区域代码的列表，请参阅 Amazon Web Services 一般参考 指南。输出格式的 json 设置是几个可能的值之一。

按照此部分中的指导创建 config 文件。

为 SDK 设置临时凭证

通过访问门户 AWS 访问 AWS 账户 和 IAM 角色后，请使用临时证书配置您的开发环境以供开发工具包访问。

使用临时凭证设置本地 credentials 文件的步骤

  1. 创建共享 credentials 文件。

  2. 在 credentials 文件中，粘贴以下占位符文本，直到粘贴有效的临时凭证为止。

    [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. 保存该文件。该 ~/.aws/credentials 文件现在应该存在于您的本地开发系统上。此文件包含 [默认] 配置文件，如果未指定特定的命名配置文件，则适用于 Java 的 SDK 将使用该配置文件。

  4. 登录 AWS 访问门户。

  5. 按照手动刷新凭证标题下的说明从 AWS 访问门户复制 IAM 角色证书。

    1. 对于链接的说明中的步骤 4，选择可授予访问权限以满足您的开发需求的 IAM 角色名称。此角色的名称通常类似于PowerUserAccess或开发人员。

    2. 对于步骤 7，选择将配置文件手动添加到您的 AWS 凭证文件选项并复制内容。

  6. 将复制的凭证粘贴到您的本地 credentials 文件中，并移除所有已粘贴的配置文件名称。您的文件应类似于以下内容：

    [default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE

  7. 保存 credentials 文件

当适用于 Java 的 SDK 创建服务客户端时，它将访问这些临时凭证并将它们用于每个请求。在步骤 5a 中选择的 IAM 角色的设置决定了临时凭证的有效时间。最长持续时间为 12 小时。

在临时凭证过期后，重复步骤 4 到 7。

安装 Java 开发环境

AWS SDK for Java V1 需要 Java 7 JDK 或更高版本，并且支持所有 Java LTS（长期支持）JDK 版本。如果您使用版本为 1.12.767 或更早版本的 SDK，则可以使用 Java 7，但是如果您使用版本为 1.12.768 或更高版本的 SDK，则需要 Java 8。Maven 中央存储库列出了适用于 Java 的 SDK 的最新版本。

AWS SDK for Java 它可与 Oracle Java SE 开发套件以及 A mazon Corret to、Red Hat OpenJDK 和 Adoptium 等开放式 Java 开发套件 (OpenJDK) 的发行版配合使用。