配置Amazon区域 - Amazon SDK for .NET
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

配置Amazon区域

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

要查看当前各区域和终端节点列表,请执行以下操作:Amazon服务,请参阅服务终端节点和配额中的Amazon一般参考. 要查看现有区域终端节点的列表,请参阅Amazon服务终端节点. 要查看有关区域的详细信息,请参阅管理Amazon区域.

您可以创建Amazon服务客户端转到具体区域. 您还可以使用将用于的区域配置应用程序所有Amazon服务客户端. 接下来,将介绍这两种情况。

使用特定地区创建服务客户端

您可以为任一项指定区域Amazon应用程序中的服务客户端。以此方式设置区域优先于该特定服务客户端的任何全局设置。

现有地区

此示例向您演示如何实例化Amazon EC2 客户端在现有地区中。它使用定义RegionEndpoint字段之间没有不同。

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

使用的新区域 RegionEndpoint 班级

此示例向您演示如何使用区域端点 .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属性来指定区域;在此示例中,使用卓越亚马逊 EC2Config类。

即使区域终端节点未遵循常规区域终端节点模式,此技术仍适用。

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 }

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

您可以通过多种方法为所有的Amazon应用程序创建的服务客户端。此区域用于不是使用特定区域创建的服务客户端。

这些区域有:Amazon SDK for .NET按以下顺序查找区域值。

配置文件

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

环境变量

设置在AWS_REGION环境变量。

在 Linux 或 macOS 上:

export AWS_REGION='us-west-2'

在 Windows 上:

set AWS_REGION=us-west-2
注意

如果为整个系统设置此环境变量(使用export要么setx),它会影响所有 SDK 和工具包,而不仅仅是Amazon SDK for .NET.

AWSConfigs 类

设置为AWSConfigs.AWSS 区域财产。

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

有关中国(北京)区域的特殊信息

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

有关新的特殊信息Amazon服务

NewAmazon服务首先可以在少数几个区域中推出,然后在其他区域中支持。在这些情况下,您无需安装最新的开发工具包来访问该服务的新区域。如前所示,您可以按每个客户端或者在全球范围内指定新添加的区域。