設定 AWS 區域

第 4 版 (V4) SDK for .NET 正在預覽！若要在預覽中查看此新版本的相關資訊，請參閱 AWS SDK for .NET （第 4 版預覽） 開發人員指南。

請注意，開發套件的 V4 處於預覽狀態，因此其內容可能會有所變更。

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

第 4 版 (V4) SDK for .NET 正在預覽！若要在預覽中查看此新版本的相關資訊，請參閱 AWS SDK for .NET （第 4 版預覽） 開發人員指南。

請注意，開發套件的 V4 處於預覽狀態，因此其內容可能會有所變更。

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

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 屬性來指定區域；在此情況下，請使用 AmazonEC2Config 類別。

即使區域端點未遵循一般區域端點模式，此技術仍然有效。

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

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 區域，則 會 SDK for .NET 嘗試尋找 AWS 服務用戶端要操作的區域。

如果找不到區域，開發套件會擲回例外狀況，指出 AWS 服務用戶端沒有設定的區域。

有關中國 （北京） 區域的特別資訊

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

新 AWS 服務的特殊資訊

新的 AWS 服務最初可以在幾個區域中啟動，然後在其他區域中支援。在這些情況下，您不需要安裝最新的 SDK 即可存取該服務的新區域。您可以依用戶端或全域指定新增的區域，如先前所示。