要使用的基本设置 Amazon Web Services 服务 - Amazon SDK for Java 1.x
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

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

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

概述

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

重要

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

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

Amazon 访问门户的登录能力

Amazon 访问门户是您手动登录IAM身份中心的 Web 位置。的格式URL是d-xxxxxxxxxx.awsapps.com/startyour_subdomain.awsapps.com/start

如果您不熟悉 Amazon 访问门户,请按照 Amazon SDKs和工具参考指南中 Identity Cent er IAM 身份验证主题步骤 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角色后,请使用临时证书配置您的开发环境SDK以供其访问。

使用临时凭证设置本地 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 文件现在应该存在于您的本地开发系统上。此文件包含 [默认] 配置文件,如果未指定特定的命名配置文件,for 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 文件

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

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

安装 Java 开发环境

Amazon SDK for Java V1 需要 Java 7 JDK 或更高版本。如果您使用的 1.12.767 或更早版本SDK,则可以使用 Java 7,但是如果您使用版本 1.12.768 或更高版本SDK,则需要 Java 8。Maven 中央存储库列出了SDK适用于 Java 的最新版本。

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