Amazon Web Services 区域 - Amazon 软件开发工具包和工具
与 Amazon SDK 的兼容性
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Amazon Web Services 区域

Amazon Web Services 区域 是使用时需要理解的重要概念 Amazon Web Services。

使用 Amazon Web Services 区域，您可以访问 Amazon Web Services 实际居住在特定地理区域的内容。这可用于保证您的数据和应用程序接近您和用户访问它们的位置。区域提供容错能力、稳定性和弹性，还可以减少延迟。使用区域，您能够创建保持可用且不受区域中断影响的冗余资源。

大多数 Amazon Web Service 请求都与特定的地理区域相关联。除非您明确使用 Amazon Web Service提供的复制功能，否则在一个区域中创建的资源在任何其他区域中都不存在。例如，Amazon S3 和 Amazon EC2 支持跨区域复制。某些服务（例如 IAM）没有区域资源。

Amazon Web Services 一般参考 包含有关以下内容的信息：

  • 要了解区域和端点之间的关系，并查看现有区域端点的列表，请参阅Amazon 服务端点。

  • 要查看所有支持的区域和每个区域的终端节点的当前列表 Amazon Web Service，请参阅服务终端节点和配额。

创建服务客户端

为了以编程方式进行访问 Amazon Web Services，SDK 为每个开发工具包使用一个客户端类/对象。 Amazon Web Service例如，如果您的应用程序需要访问 Amazon EC2，则您的应用程序将创建一个 Amazon EC2 客户端对象来与该服务交互。

如果没有为客户端明确指定区域，则客户端将默认使用通过以下region设置项目所设置的区域。但是，可以为任何单个客户端对象显式设置客户端的活动区域。以这种方式设置区域优先于该特定服务客户端的任何全局设置。备用区域是在该客户端的实例化过程中指定的，该区域特定于您的 SDK（请查看您的特定 SDK 指南或 SDK 的代码库）。

使用以下方法配置此功能：

region-共享 Amazon config文件设置
AWS_REGION - 环境变量
aws.region-JVM 系统属性：仅限 Java/Kotlin

指定 Amazon 请求 Amazon Web Services 区域 使用的默认值。此区域用于未提供特定区域的 SDK 服务请求。

默认值：无。必须明确指定此值。

有效值：

  • 可用于所选服务的任何区域代码，有关列表，请参阅 Amazon 一般参考中的 Amazon 服务端点。例如，该值将终端节点us-east-1设置为 Amazon Web Services 区域 美国东部（弗吉尼亚北部）。

  • aws-global为除区域终端节点之外还支持单独的全局终端节点的服务指定全局终端节点，例如 Amazon Security Token Service (Amazon STS) 和亚马逊简单存储服务 (Amazon S3) Service。

在 config 文件中设置此值的示例：

[default]
region = us-west-2

Linux/macOS 通过命令行设置环境变量的示例：

export AWS_REGION=us-west-2

Windows 通过命令行设置环境变量的示例：

setx AWS_REGION us-west-2

大多数 SDK 都有“配置”对象，可用于在应用程序代码中设置默认区域。有关详细信息，请参阅您的特定 Amazon SDK 开发者指南。

与 Amazon SDK 的兼容性

以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。 Amazon SDK for Java 和 Amazon SDK for Kotlin 唯一支持任何 JVM 系统属性设置。

SDK 支持 备注或更多信息
Amazon CLI v2 支持 Amazon CLI v2 在中的任何值AWS_REGION之前使用中的任何值AWS_DEFAULT_REGION（两个变量都被选中）。
Amazon CLI v1 支持 Amazon CLI v1 使用AWS_DEFAULT_REGION为此目的命名的环境变量。
适用于 C++ 的 SDK 支持
适用于 Go V2 (1.x) 的 SDK 支持
适用于 Go 1.x（V1）的 SDK 支持 要使用共享 config 文件设置，必须开启从配置文件加载的功能；请参阅会话。
适用于 Java 2.x 的 SDK 支持
适用于 Java 1.x 的 SDK 支持
适用于 JavaScript 3.x 的软件开发工具包 支持
适用于 JavaScript 2.x 的 SDK 支持
适用于 Kotlin 的 SDK 支持
适用于 .NET 3.x 的 SDK 支持
适用于 PHP 3.x 的 SDK 支持
适用于 Python (Boto3) 的 SDK 支持 此 SDK 使用名为 AWS_DEFAULT_REGION 的环境变量来实现此目的。
适用于 Ruby 3.x 的 SDK 支持
适用于 Rust 的 SDK 支持
用于 PowerShell 支持