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

# EBS 直接 APIs 的服務端點
<a name="using-endpoints"></a>

*端點*是做為 AWS Web 服務進入點的 URL。EBS 直接 API 支援下列端點類型：
+ IPv4 端點
+ 同時支援 IPv4 和 IPv6 的雙堆疊端點
+ FIPS 端點

當您提出請求時，您可以指定要使用的端點和區域。如果您沒有指定端點，則預設使用 IPv4 端點。若要使用不同的端點類型，您必須在請求中將其指定。如需如何執行此作業的範例，請參閱 [指定端點](#examples)。

如需區域的詳細資訊，請參閱《*Amazon EC2 使用者指南*》中的[區域和可用區域](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html)。如需 EBS 直接 API 的端點清單，請參閱《Amazon Web Services 一般參考》**中的 [EBS 直接 API 的端點](https://docs.aws.amazon.com/general/latest/gr/ebs-service.html#ebs_direct_apis)。

**Topics**
+ [IPv4 端點](#ipv4)
+ [雙堆疊 (IPv4 和 IPv6) 端點](#ipv6)
+ [FIPS 端點](#fips)
+ [指定端點](#examples)

## IPv4 端點
<a name="ipv4"></a>

IPv4 端點僅支援 IPv4 流量。IPv4 端點適用於所有區域。

EBS APIs 僅支援區域 IPv4 端點，您可以用來提出請求。您必須指定區域做為端點名稱的一部分。端點名稱使用以下命名慣例：
+ `ebs.region.amazonaws.com`

例如，若要將請求導向 `us-east-2` IPv4 端點，您必須指定 `ebs.us-east-2.amazonaws.com`做為端點。如需 EBS 直接 API 的端點清單，請參閱《Amazon Web Services 一般參考》**中的 [EBS 直接 API 的端點](https://docs.aws.amazon.com/general/latest/gr/ebs-service.html#ebs_direct_apis)。

**定價**  
對於使用相同區域中的 IPv4 端點在 EBS 直接 API 和 Amazon EC2 執行個體間直接傳輸的資料，您無需付費。不過，如果有 AWS PrivateLink 端點、NAT Gateway 或 Amazon VPC Transit Gateways 等中繼服務，則會向您收取相關費用。

## 雙堆疊 (IPv4 和 IPv6) 端點
<a name="ipv6"></a>

雙堆疊端點同時支援 IPv4 和 IPv6 流量。雙堆疊端點適用於所有區域。

若要使用 IPv6，您必須使用雙堆疊端點。當您請求雙堆疊端點時，端點 URL 會解析為 IPv6 或 IPv4 地址，具體視您的網路和用戶端使用的通訊協定而異。

EBS 直接 API 僅支援區域雙堆疊端點，亦即，指定的端點名稱必須包含區域。雙堆疊端點名稱使用以下命名慣例：
+ `ebs.region.api.aws`

例如，`eu-west-1` 區域的雙堆疊端點名稱是 `ebs.eu-west-1.api.aws`。如需 EBS 直接 API 的端點清單，請參閱《Amazon Web Services 一般參考》**中的 [EBS 直接 API 的端點](https://docs.aws.amazon.com/general/latest/gr/ebs-service.html#ebs_direct_apis)。

**定價**  
對於使用相同區域中的雙堆疊端點在 EBS 直接 API 和 Amazon EC2 執行個體間直接傳輸的資料，您無需付費。不過，如果有 AWS PrivateLink 端點、NAT Gateway 或 Amazon VPC Transit Gateways 等中繼服務，則會向您收取相關費用。

## FIPS 端點
<a name="fips"></a>

EBS 直接 API 為下列區域提供通過 FIPS 驗證的 IPv4 和雙堆疊 (IPv4 和 IPv6) 端點：
+ `us-east-1` — 美國東部 (維吉尼亞北部)
+ `us-east-2` — 美國東部 (俄亥俄)
+ `us-west-1` — 美國西部 (加利佛尼亞北部)
+ `us-west-2` — 美國西部 (奧勒岡)
+ `ca-central-1` — 加拿大 (中部)
+ `ca-west-1` — 加拿大西部 （卡加利）

**FIPS IPv4 端點**使用以下命名慣例：`ebs-fips.region.amazonaws.com`。例如，`us-east-1` 的 FIPS IPv4 端點是 `ebs-fips.us-east-1.amazonaws.com`。

**FIPS 雙堆疊端點**使用以下命名慣例：`ebs-fips.region.api.aws`。例如，`us-east-1` 的 FIPS 雙堆疊端點是 `ebs-fips.us-east-1.api.aws`。

如需有關 FIPS 端點的詳細資訊，請參閱《Amazon Web Services 一般參考》**中的 [FIPS 端點](https://docs.aws.amazon.com/general/latest/gr/rande.html#FIPS-endpoints)。

## 指定端點
<a name="examples"></a>

本節提供一些在提出請求時如何指定端點的範例。

------
#### [ AWS CLI ]

下列範例顯示如何使用 AWS CLI指定 `us-east-2`區域的端點。
+ **雙堆疊**

  ```
  aws ebs list-snapshot-blocks --snapshot-id snap-0987654321 --starting-block-index 1000 --endpoint-url https://ebs.us-east-2.api.aws
  ```
+ **IPv4**

  ```
  aws ebs list-snapshot-blocks --snapshot-id snap-0987654321 --starting-block-index 1000 --endpoint-url https://ebs.us-east-2.amazonaws.com
  ```

------
#### [ AWS SDK for Java 2.x ]

下列範例顯示如何使用 AWS SDK for Java 2.x指定 `us-east-2`區域的端點。
+ **雙堆疊**

  ```
  AwsClientBuilder.EndpointConfiguration config = new AwsClientBuilder.EndpointConfiguration("https://ebs.us-east-2.api.aws", "us-east-2");
  AmazonEBS ebs = AmazonEBSClientBuilder.standard()
      .withEndpointConfiguration(config)
      .build();
  ```
+ **IPv4**

  ```
  AwsClientBuilder.EndpointConfiguration config = new AwsClientBuilder.EndpointConfiguration("https://ebs.us-east-2.amazonaws.com", "us-east-2");
  AmazonEBS ebs = AmazonEBSClientBuilder.standard()
      .withEndpointConfiguration(config)
      .build();
  ```

------
#### [ AWS SDK for Go ]

下列範例顯示如何使用 適用於 Go 的 AWS SDK指定 `us-east-2`區域的端點。
+ **雙堆疊**

  ```
  sess := session.Must(session.NewSession())
  svc := ebs.New(sess, &aws.Config{
      Region: aws.String(endpoints.UsEast2RegionID),
      Endpoint: aws.String("https://ebs.us-east-2.api.aws")
  })
  ```
+ **IPv4**

  ```
  sess := session.Must(session.NewSession())
  svc := ebs.New(sess, &aws.Config{
      Region: aws.String(endpoints.UsEast2RegionID),
      Endpoint: aws.String("https://ebs.us-east-2.amazonaws.com")
  })
  ```

------