配置 AWS 区域 - 适用于 .NET 的 AWS 开发工具包
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

配置 AWS 区域

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

要查看每个的所有受支持区域和端点的当前列表 AWS 服务,请参阅 服务端点和配额AWS General Reference. 要查看现有区域端点的列表,请参阅 AWS 服务端点. 要查看有关地区的详细信息,请参阅 管理 AWS 地区.

您可以创建 AWS 服务客户 特定区域. 您还可以使用将用于以下对象的区域配置应用程序 全部 AWS 服务客户. 下面将解释这两种情况。

创建具有特定区域的服务客户端

您可以为任意 AWS 应用程序中的服务客户端。以这种方式设置区域优先于该特定服务客户端的任何全局设置。

现有区域

此示例向您展示了如何实例化 Amazon EC2 客户 现有区域。它使用定义的 区域端点 字段。

using (AmazonEC2Client ec2Client = new AmazonEC2Client(RegionEndpoint.USWest2)) { // Make a request to EC2 in the us-west-2 Region using ec2Client }

使用RegionEndpoint类的新区域

此示例显示了如何通过使用 RegionEndpoint.GetBySystemName(地区端点.GetBy系统名称).

var newRegion = RegionEndpoint.GetBySystemName("us-west-new"); using (var ec2Client = new AmazonEC2Client(newRegion)) { // Make a request to EC2 in the new Region using ec2Client }

使用服务客户端配置类的新区域

此示例向您展示如何使用 ServiceURL 属性,以指定区域;在这种情况下,使用 AmazonEC2配置 类。

即使Region(地区)端点不遵循常规的Region(地区)端点模式,此技术也有效。

var ec2ClientConfig = new AmazonEC2Config { // Specify the endpoint explicitly ServiceURL = "https://ec2.us-west-new.amazonaws.com" }; using (var ec2Client = new AmazonEC2Client(ec2ClientConfig)) { // Make a request to EC2 in the new Region using ec2Client }

为所有服务客户端指定区域

有几种方式可以指定所有 AWS 您的应用程序创建的服务客户端。此区域用于未使用特定区域创建的服务客户。

适用于 .NET 的 AWS 开发工具包按以下顺序查找区域值:

Profiles

在应用程序或SDK已加载的配置文件中设置。有关更多信息,请参阅 凭证和配置文件解析。)

环境变量.

在中设置 AWS_REGION 环境变量。

在 Linux 或 macOS 上:

AWS_REGION='us-west-2'

在 Windows 上

set AWS_REGION=us-west-2
注意

如果您为整个系统设置此环境变量(使用 exportsetx),它影响所有SDK和工具包,而不仅仅是 适用于 .NET 的 AWS 开发工具包.

AWSConfigs类

设置为 AWSConfigs.AWSRegion(AWS区域) 属性。

AWSConfigs.AWSRegion = "us-west-2"; using (var ec2Client = new AmazonEC2Client()) { // Make request to Amazon EC2 in us-west-2 Region using ec2Client }

关于中国(北京)地区的特别信息

要使用中国 (北京) 区域中的服务,您必须拥有特定于中国 (北京) 区域的账户和凭证。其他帐户和凭证 AWS 中国(北京)区不工作。同样,中国(北京)地区的账户和凭证也不适用于其他 AWS 区域。有关在中国 (北京) 区域中可用的终端节点和协议的信息,请参阅中国 (北京) 区域

关于新信息的特殊信息 AWS 服务

新 AWS 服务最初可以在几个地区启动,然后在其他地区支持。在这些情况下,您无需安装最新的SDK即可访问该服务的新区域。您可以按每个客户或全局指定新添加的区域,如前所示。