第 4 版 (V4) 適用於 .NET 的 AWS SDK 已發行！

如需有關中斷變更和遷移應用程式的資訊，請參閱[遷移主題](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)。

 [https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)

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

# 設定 AWS 的區域 適用於 .NET 的 AWS SDK
<a name="net-dg-region-selection"></a>

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

若要檢視每個 AWS 服務所有支援的區域和端點的目前清單，請參閱 中的[服務端點和配額](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html)*AWS 一般參考*。若要檢視現有區域端點的清單，請參閱 [AWS 服務端點](https://docs.aws.amazon.com/general/latest/gr/rande.html)。若要查看區域的詳細資訊，請參閱[指定 AWS 您的帳戶可以使用的區域](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html)。

您可以建立前往[特定區域的](#per-client) AWS 服務用戶端。您也可以使用將用於[所有 AWS 服務用戶端](#globally)的區域來設定應用程式。接下來會說明這兩個案例。

## 使用特定區域建立服務用戶端
<a name="per-client"></a>

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

### 現有區域
<a name="w2aac11c19c11b5"></a>

此範例說明如何在現有區域中執行個體化 [Amazon EC2 用戶端](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/EC2/TEC2Client.html)。它使用定義的 [RegionEndpoint](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TRegionEndpoint.html) 欄位。

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

### 使用 RegionEndpoint 類別的新區域
<a name="w2aac11c19c11b7"></a>

此範例說明如何使用 [RegionEndpoint.GetBySystemName](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/MRegionEndpointGetBySystemNameString.html) 建構新的區域端點。

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

### 使用服務用戶端組態類別的新區域
<a name="w2aac11c19c11b9"></a>

此範例說明如何使用服務用戶端組態類別的 `ServiceURL` 屬性來指定 區域；在此情況下，請使用 [AmazonEC2Config](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/EC2/TEC2Config.html) 類別。

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

```
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
}
```

## 為所有服務用戶端指定區域
<a name="globally"></a>

您可以透過多種方式為您的應用程式建立的所有 AWS 服務用戶端指定區域。此區域用於未以特定區域建立的服務用戶端。

會依下列順序 適用於 .NET 的 AWS SDK 尋找區域值。

### 描述檔
<a name="w2aac11c19c15b7"></a>

在應用程式或 SDK 已載入的設定檔中設定 。如需詳細資訊，請參閱[憑證和設定檔解析](creds-assign.md)。

### 環境變數
<a name="w2aac11c19c15b9"></a>

在`AWS_REGION`環境變數中設定 。

在 Linux 或 macOS 上：

```
export AWS_REGION='us-west-2'
```

在 Windows 上：

```
set AWS_REGION=us-west-2
```

**注意**  
如果您為整個系統 （使用 `export`或 `setx`) 設定此環境變數，它會影響所有 SDKs 和工具組，而不只是 適用於 .NET 的 AWS SDK。

### AWSConfigs 類別
<a name="w2aac11c19c15c11"></a>

設定為 [AWSConfigs.AWSRegion](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html) 屬性。

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

## 區域解析
<a name="net-dg-region-resolution"></a>

如果上述方法都未用於指定 AWS 區域，則 會 適用於 .NET 的 AWS SDK 嘗試尋找 AWS 服務用戶端要操作的區域。

**區域解析順序**

1. 應用程式組態檔案，例如 `app.config`和 `web.config`。

1. 環境變數 (`AWS_REGION` 和 `AWS_DEFAULT_REGION`)。

1. 描述檔，其名稱由 中的值指定`AWSConfigs.AWSProfileName`。

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

1. `[default]` 設定檔。

1. Amazon EC2 執行個體中繼資料 （如果在 EC2 執行個體上執行）。

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

## 中國 （北京） 區域的特殊資訊
<a name="net-dg-region-cn-north-1"></a>

若要使用中國 (北京) 地區中的服務，您必須有專屬於中國 (北京) 地區的帳戶和憑證。其他 AWS 區域的帳戶和登入資料不適用於中國 （北京） 區域。同樣地，中國 （北京） 區域的帳戶和登入資料不適用於其他 AWS 區域。如需中國 （北京） 區域中可用端點和通訊協定的相關資訊，請參閱[北京區域端點](https://docs.amazonaws.cn/en_us/aws/latest/userguide/endpoints-Beijing.html)。

## 新 AWS 服務的特殊資訊
<a name="net-dg-region-new-services"></a>

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