設定AWS區域 - AWS SDK for .NET

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

設定AWS區域

AWS區域可讓您存取實際位於特定地理區域的AWS服務。這對於備援以及讓您的資料和應用程式,在靠近您和您的使用者存取位置附近執行,都很有用。

若要檢視每個AWS服務之所有支援區域和端的目前清單,請參閱 AWS 一般參考. 若要檢視現有地區端點的清單,請參閱AWS服務端點。若要查看區域的詳細資訊,請參閱指定您的帳戶可以使用的AWS區域

您可以創建轉到特定區域的AWS服務客戶端。您也可以使用將用於所有AWS服務用戶端的區域來設定應用程式。接下來將解釋這兩種情況。

建立具有特定區域的服務用戶端

您可以為應用程式中的任何AWS服務用戶端指定「區域」。以這種方式設定區域的優先順序高於該特定服務用戶端的任何全域設定。

現有地區

此範例說明如何在現有區域中實例化 Amazon EC2 用戶端。它使用定義的RegionEndpoint字段。

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

使用 RegionEndpoint 類別的新區域

此範例說明如何使用建構新的「區域」端點RegionEndpoint。 GetBySystemName

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屬性來指定區域; 在這種情況下,使用 AmazonEC 2config 類。

即使 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服務用戶端指定「區域」。此區域用於未使用特定區域建立的服務用戶端。

會依下列順序AWS SDK for .NET尋找「區域」值。

描述檔

在您的應用程序或 SDK 已加載的配置文件中設置。如需詳細資訊,請參閱憑證和設定檔解析

環境變數

AWS_REGION環境變數中設定。

在 Linux 或 macOS 上:

export AWS_REGION='us-west-2'

在 Windows 上:

set AWS_REGION=us-west-2
注意

如果您為整個系統設定此環境變數 (使用exportsetx),它會影響所有 SDK 和工具組,而不僅影響. AWS SDK for .NET

AWSConfigs 類

設定為 AWSConfigs. AWSRegion財產。

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

區域解析度

如果上述方法都不用於指定AWS 區域,則會AWS SDK for .NET嘗試尋找AWS服務用戶端要在其中運作的區域。

區域解析順序
  1. 應用程式組態檔案,例如app.configweb.config

  2. 環境變數 (AWS_REGIONAWS_DEFAULT_REGION)。

  3. 具有由中的值指定名稱的設定檔AWSConfigs.AWSProfileName

  4. 具有由AWS_PROFILE環境變數指定名稱的設定檔。

  5. [default]定檔。

  6. Amazon EC2 執行個體中繼資料 (如果在 EC2 執行個體上執行)。

如果找不到區域,SDK 會擲回例外狀況,指出AWS服務用戶端沒有設定區域。

關於中國(北京)地區的特殊信息

若要使用中國 (北京) 地區中的服務,您必須有專屬於中國 (北京) 地區的帳戶和憑證。其他 AWS 區域的帳戶和憑證無法用於中國 (北京) 區域。同樣地,中國 (北京) 區域的帳戶和憑證無法用於其他 AWS 區域。如需中國 (北京) 區域可用之端點和通訊協定的相關資訊,請參閱北京地區端點

有關新AWS服務的特殊信息

新AWS服務最初可在幾個區域推出,然後在其他地區提供支援。在這些情況下,您不需要安裝最新的 SDK 即可存取該服務的新區域。您可以針對每個用戶端或全域指定新增的區域,如前所示。