View a markdown version of this page

要使用的基本设置 Amazon Web Services 服务 - Amazon SDK for Java 1.x
概述Amazon 访问门户的登录能力设置共享配置文件安装 Java 开发环境
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon SDK for Java 1.x于2025年12月31日达到支撑终止状态。我们建议您迁移到 Amazon SDK for Java 2.x 以继续获得新功能、可用性改进和安全更新。

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

要使用的基本设置 Amazon Web Services 服务

概述

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

重要

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

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

Amazon 访问门户的登录能力

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

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

设置共享配置文件

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

设置共享 config 文件

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

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

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

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

为 SDK 设置临时凭证

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

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

  1. 创建共享 credentials 文件。

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

    [default]
aws_access_key_id=<value from Amazon access portal>
aws_secret_access_key=<value from Amazon access portal>
aws_session_token=<value from Amazon access portal>

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

  4. 登录 Amazon 访问门户。

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

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

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

  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 开发环境

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

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