AWS 区域 选择 - 适用于 Java 的 AWS SDK 1.x
查看区域的服务可用性选择区域选择特定终端节点根据环境自动确定区域

适用于 Java 的 AWS SDK 1.x 版本自 2024 年 7 月 31 日起已进入维护模式，并将于 2025 年 12 月 31 日终止支持。我们建议您迁移到 AWS SDK for Java 2.x 以继续获得新功能、可用性改进和安全更新。

AWS 区域 选择

使用区域可以访问实际位于特定地理区域的 AWS 服务。它可以用于保证冗余，并保证您的数据和应用程序接近您和用户访问它们的位置。

查看区域的服务可用性

要确认在一个区域内特定的 AWS 服务是否可用，请对要使用的区域使用 isServiceSupported 方法。

Region.getRegion(Regions.US_WEST_2)
    .isServiceSupported(AmazonDynamoDB.ENDPOINT_PREFIX);

请参阅区域类文档查看可以指定的区域，并使用服务的终端节点前缀进行查询。在服务接口中定义了各服务的终端节点前缀。例如，DynamoDB 的终端节点前缀在 AmazonDynamoDB 中定义。

选择区域

从适用于 Java 的 AWS SDK 的 1.4 版本开始，您可指定区域名称，然后开发工具包将自动选择适当的终端节点。要自行选择终端节点，请参阅选择特定终端节点。

要显式设置区域时，我们建议您使用 Regions 枚举。这是所有公开可用区域的枚举。要使用枚举结果中的一个区域创建客户端，请使用以下代码。

AmazonEC2 ec2 = AmazonEC2ClientBuilder.standard()
                    .withRegion(Regions.US_WEST_2)
                    .build();

如果 Regions 枚举结果不包含要使用的某个区域，可使用代表该区域名称的字符串。

AmazonEC2 ec2 = AmazonEC2ClientBuilder.standard()
                    .withRegion("{region_api_default}")
                    .build();
注意

使用生成器所构建的客户端不可改变，而且不能更改区域。如果要为同一项服务使用多个 AWS 区域，请创建多个客户端，即每个区域一个客户端。

选择特定终端节点

在创建客户端时调用 withEndpointConfiguration 方法，即可将各个 AWS 客户端配置为使用一个区域内的特定端点。

例如，要将 Amazon S3 客户端配置为使用“欧洲地区（爱尔兰）”区域，请使用以下代码。

AmazonS3 s3 = AmazonS3ClientBuilder.standard()
     .withEndpointConfiguration(new EndpointConfiguration(
          "https://s3.eu-west-1.amazonaws.com",
          "eu-west-1"))
     .withCredentials(CREDENTIALS_PROVIDER)
     .build();

有关所有 AWS 服务的区域及其相应端点的最新列表，请参阅区域和端点。

根据环境自动确定区域

重要

本部分仅适用于使用客户端生成器访问 AWS 服务的情况。使用客户端构造函数创建的 AWS 客户端不会自动根据环境确定区域，而是使用默认 SDK 区域（USEast1）。

在 Amazon EC2 或 Lambda 上运行时，可能需要将客户端配置为与所运行的代码使用同一个区域。由此可以将代码从其运行的环境中脱离，更轻松地将应用程序部署到多个区域以减少延迟并保证冗余。

必须使用客户端生成器，使开发工具包可自动检测代码的运行区域。

要使用默认的凭证/区域提供程序链来根据环境确定区域，请使用客户端生成器的 defaultClient 方法：

AmazonEC2 ec2 = AmazonEC2ClientBuilder.defaultClient();

这与使用 standard 再加上 build 相同。

AmazonEC2 ec2 = AmazonEC2ClientBuilder.standard()
                    .build();

如果您没有使用 withRegion 方法明确设置一个区域，开发工具包将参考默认区域提供程序链来尝试并确定要使用的区域。

默认区域提供程序链

区域查找过程如下：

  1. 通过生成器本身使用 withRegion 或 setRegion 明确设置的所有区域优先于其他所有区域。

  2. 系统会检查 AWS_REGION 环境变量。如果已设置该变量，将使用对应区域配置客户端。

    注意

    该环境变量通过 Lambda 容器设置。

  3. SDK 将检查 AWS 共享配置文件（通常位于 ~/.aws/config）。如果 region 属性存在，则 SDK 会使用该属性。

    • AWS_CONFIG_FILE 环境变量可用于自定义共享配置文件的位置。

    • 可以使用 AWS_PROFILE 环境变量或 aws.profile 系统属性，自定义 SDK 要加载的配置文件。

  4. 开发工具包将尝试使用 Amazon EC2 实例元数据服务，为当前运行的 Amazon EC2 实例确定区域。

  5. 如果开发工具包此时仍不能确定区域，则客户端创建将失败并返回异常。

开发 AWS 应用程序的一个常用方法是使用共享配置文件（如使用默认凭证提供程序链中所述）在本地开发时设置区域，而在 AWS 基础设施上运行时依赖默认区域提供程序链确定区域。这可以明显简化客户端创建，并保证应用程序的便携性。