适用于 Java 的 Amazon SDK 1.x 已于 2025 年 12 月 31 日终止支持。我们建议您迁移到 [Amazon SDK for Java 2.x](https://docs.amazonaws.cn/sdk-for-java/latest/developer-guide/home.html) 以继续获得新功能、可用性改进和安全更新。 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 文档历史记录 本页列出了《适用于 Java 的 Amazon SDK 开发人员指南》在其发展历程中的重要更改。 **本指南发布于：**2025 年 10 月 1 日。 2025 年 10 月 1 日 添加将于 2026 年 9 月 27 日到期的新 [PGP 密钥](openpgp.md#pgp-current-keys)。 2024 年 10 月 5 日 更新[当前 OpenPGP 密钥信息](openpgp.md)。 2024 年 9 月 4 日 为 DynamoDB 添加基于 Amazon 账户的端点的相关信息。请参阅[使用基于 Amazon 账户的端点](examples-dynamodb.md#account-based-endpoint-routing)。 2024 年 5 月 21 日 移除有关使用 java 命令行系统属性设置 `networkaddress.cache.ttl` 安全属性的说明。请参阅[如何设置 JVM TTL](jvm-ttl-dns.md#how-to-set-the-jvm-ttl)。 2024 年 1 月 12 日 添加宣布终止对 适用于 Java 的 Amazon SDK v1.x 的支持的横幅。 2023 年 12 月 6 日 + 提供[当前 OpenPGP 密钥](openpgp.md)。 2023 年 3 月 14 日 + 更新了指南，使其符合 IAM 最佳实践。有关更多信息，请参阅 [IAM 安全最佳实践](https://docs.amazonaws.cn/IAM/latest/UserGuide/best-practices.html)。 2022 年 7 月 28 日 + 添加了 EC2-Classic 将于 2022 年 8 月 15 日停用的提醒。 2018 年 3 月 22 日 + 删除了在 DynamoDB 中管理 Tomcat 会话的示例，因为该工具不再受到支持。 2017 年 11 月 2 日 + 添加了 Amazon S3 加密客户端的加密示例，包括新主题：[使用 Amazon S3 客户端加密](examples-crypto.md)、[Amazon S3 客户端加密配合 Amazon KMS 托管密钥](examples-crypto-kms.md)和 [Amazon S3 客户端加密配合客户端主密钥](examples-crypto-masterkey.md)。 2017 年 8 月 14 日 + 对[使用适用于 Java 的 Amazon SDK 的 Amazon S3 示例](examples-s3.md)部分进行了多处更新，包括新主题：[管理对桶和对象的 Amazon S3 访问权限](examples-s3-access-permissions.md)和[将 Amazon S3 桶配置为网站](examples-s3-website-configuration.md)。 2017 年 4 月 4 日 + 新增主题[为适用于 Java 的 Amazon SDK 启用指标](generating-sdk-metrics.md)，描述如何为适用于 Java 的 Amazon SDK 生成应用程序和 SDK 性能指标。 2017 年 4 月 3 日 + [使用适用于 Java 的 Amazon SDK 的 CloudWatch 示例](examples-cloudwatch.md)部分添加了新的 CloudWatch 示例：[从 CloudWatch 获取指标](examples-cloudwatch-get-metrics.md)、[发布自定义指标数据](examples-cloudwatch-publish-custom-metrics.md)、[使用 CloudWatch 警报](examples-cloudwatch-create-alarms.md)、[在 CloudWatch 中使用警报操作](examples-cloudwatch-use-alarm-actions.md)和[将事件发送到 CloudWatch](examples-cloudwatch-send-events.md) 2017 年 3 月 27 日 + 在[使用适用于 Java 的 Amazon SDK 的 Amazon EC2 示例](prog-services-ec2.md)部分添加了更多 Amazon EC2 示例：[管理 Amazon EC2 实例](examples-ec2-instances.md)、[在 Amazon EC2 中使用弹性 IP 地址](examples-ec2-elastic-ip.md)、[使用区域和可用区](examples-ec2-regions-zones.md)、[使用 Amazon EC2 密钥对](examples-ec2-key-pairs.md)以及[在 Amazon EC2 中使用安全组](examples-ec2-security-groups.md)。 2017 年 3 月 21 日 + [使用适用于 Java 的 Amazon SDK 的 IAM 示例](examples-iam.md)部分添加了一组新的 IAM 示例：[管理 IAM 访问密钥](examples-iam-access-keys.md)、[管理 IAM 用户](examples-iam-users.md)、[使用 IAM 账户别名](examples-iam-account-aliases.md)、[使用 IAM policy](examples-iam-policies.md) 和[使用 IAM 服务器证书](examples-iam-server-certificates.md) 2017 年 3 月 13 日 + Amazon SQS 部分添加了三个新主题：[为 Amazon SQS 消息队列启用长轮询](examples-sqs-long-polling.md)、[在 Amazon SQS 中设置可见性超时](examples-sqs-visibility-timeout.md)和[在 Amazon SQS 中使用死信队列](examples-sqs-dead-letter-queues.md)。 2017 年 1 月 26 日 + 增加了新的 Amazon S3 主题（[使用 TransferManager 执行 Amazon S3 操作](examples-s3-transfermanager.md)）以及[使用适用于 Java 的 Amazon SDK](basics.md) 部分的新主题[使用适用于 Java 的 Amazon SDK 进行 Amazon 开发的最佳实践](best-practices.md)。 2017 年 1 月 16 日 + 增加了一个新的 Amazon S3 主题（[使用桶策略管理对 Amazon S3 桶的访问](examples-s3-bucket-policies.md)）和两个新的 Amazon SQS 主题（[使用 Amazon SQS 消息队列](examples-sqs-message-queues.md)和[发送、接收和删除 Amazon SQS 消息](examples-sqs-messages.md)。 2016 年 12 月 16 日 + 增加了面向 DynamoDB 的新示例主题：[处理 DynamoDB 中的表](examples-dynamodb-tables.md)和[处理 DynamoDB 中的项目](examples-dynamodb-items.md)。 2016 年 9 月 26 日 + **高级**部分中的主题已移入[使用适用于 Java 的 Amazon SDK](basics.md) 中，因为这些主题实际上是有关使用 SDK 的中心主题。 2016 年 8 月 25 日 + 已将一个新的[创建服务客户端](creating-clients.md)主题添加到[使用适用于 Java 的 Amazon SDK](basics.md) 中，该主题说明如何使用*客户端生成器*更轻松地生成 Amazon Web Services 服务客户端。 [适用于 Java 的 Amazon SDK 代码示例](prog-services.md)部分已用[新的 S3 示例](examples-s3.md)进行了更新，这些示例由包含完整示例代码的 [GitHub 上的存储库](https://github.com/awsdocs/aws-doc-sdk-examples)提供支持。 2016 年 5 月 2 日 + 已将一个新的[异步编程](basics-async.md)主题添加到[使用适用于 Java 的 Amazon SDK](basics.md) 部分，此主题说明如何使用返回 `Future` 对象或采用 `AsyncHandler` 的异步客户端方法。 2016 年 4 月 26 日 + 已删除 *SSL 证书要求* 主题，因为该主题不再相关。2015 版本中已弃用对 SHA-1 签名证书的支持，并且已删除包含测试脚本的站点。 2016 年 3 月 14 日 + Amazon SWF 部分添加了一个新的 [Lambda 任务](swf-lambda-task.md)主题，该主题说明如何实施 Amazon SWF 工作流，此工作流将 Lambda 函数作为任务进行调用，以作为使用传统 Amazon SWF 活动的替代方法。 2016 年 3 月 4 日 + 已使用新内容更新[使用适用于 Java 的 Amazon SDK 的 Amazon SWF 示例](prog-services-swf.md)部分： + [Amazon SWF 基础知识](swf-basics.md) – 提供有关如何在项目中包含 SWF 的基本信息。 + [构建简单 Amazon SWF 应用程序](swf-hello.md) – 一个新的教程，为初次使用 Amazon SWF 的 Java 开发人员提供分步指南。 + [适当地关闭活动工作线程和工作流工作线程](swf-graceful-shutdown.md) – 说明如何使用 Java 的并发类适当地关闭 Amazon SWF 工作线程类。 2016 年 2 月 23 日 + 《适用于 Java 的 Amazon SDK 开发人员指南》的来源已移至 [aws-java-developer-guide](https://github.com/awsdocs/aws-java-developer-guide)。 2015 年 12 月 28 日 + [为 DNS 名称查找设置 JVM TTL](jvm-ttl-dns.md) 已从**高级**部分移入[使用适用于 Java 的 Amazon SDK](basics.md) 部分，并且为清楚起见，已重新编写此主题。 已使用有关如何在项目中包含开发工具包的物料清单 (BOM) 的信息更新[将开发工具包与 Apache Maven 一起使用](setup-project-maven.md)。 2015 年 8 月 4 日 + *SSL 证书要求* 是[入门](getting-started.md)部分中的一个新主题，此主题说明 Amazon 如何移至 SSL 连接的 SHA256 签名证书，以及如何修复 1.6 版和以前的 Java 环境以使用这些证书（自 2015 年 9 月 30 日起，*需要* 这些证书才能访问 Amazon）。 **注意** Java 1.7\+ 已能够使用 SHA256 签名证书。 2014 年 5 月 14 日 + 已对[简介](welcome.md)和[入门](getting-started.md)内容进行大量修订以支持新的指南结构，并且现在包含有关如何[设置用于开发的 Amazon 凭证和区域](setup-credentials.md)的指南。 对[代码示例](java-dg-samples.md)的讨论已移至其在[其他文档和资源](welcome.md#additional-resources)部分中所对应的主题。 有关如何[查看开发工具包修订历史记录](welcome.md#java-sdk-history)的信息已移入简介部分。 2014 年 5 月 9 日 + 简化了适用于 Java 的 Amazon SDK文档的总体结构，并更新了[入门](getting-started.md)和[其他文档和资源](welcome.md#additional-resources)主题。 添加了新主题： + [使用 Amazon 凭证](credentials.md) – 讨论可用于指定要与适用于 Java 的 Amazon SDK 配合使用的凭证的各种方式。 + [使用 IAM 角色授予对 Amazon EC2 上的 Amazon 资源的访问权](java-dg-roles.md) – 提供了有关如何安全地为 EC2 实例上运行的应用程序指定凭证的信息。 2013 年 9 月 9 日 + 此*文档历史记录* 主题跟踪对《适用于 Java 的 Amazon SDK 开发人员指南》所做的更改。它旨在与发布说明历史记录一起提供。