翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# EBS direct API 用のサービスエンドポイント
<a name="using-endpoints"></a>

*エンドポイント*は、 AWS ウェブサービスのエントリポイントとして機能する URL です。EBS direct API は以下のエンドポイントタイプをサポートします。
+ IPv4 エンドポイント
+ IPv4 と IPv6 の両方をサポートするデュアルスタックのエンドポイント
+ FIPS エンドポイント

リクエストを行うと、使用するエンドポイントとリージョンを指定できます。エンドポイントを指定しない場合、デフォルトで IPv4 エンドポイントが使用されます。別のエンドポイントタイプを使用するには、リクエストで指定する必要があります。これを行う方法の例については、「[エンドポイントの指定](#examples)」を参照してください。

リージョンの詳細については、「*Amazon EC2 ユーザーガイド*」の「[リージョンとアベイラビリティーゾーン](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html)」を参照してください。EBS direct API のエンドポイントのリストについては、「*Amazon Web Services 全般のリファレンス*」の「[EBS direct 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 direct API は、リクエストの実行に使用できるリージョン IPv4 エンドポイントのみをサポートします。リージョンをエンドポイント名の一部として指定する必要があります。エンドポイント名には、次の命名規則が使用されます。
+ `ebs.region.amazonaws.com`

例えば、`us-east-2` IPv4 エンドポイントへリクエストを指示する場合、`ebs.us-east-2.amazonaws.com` をエンドポイントとして指定する必要があります。EBS direct API のエンドポイントのリストについては、「*Amazon Web Services 全般のリファレンス*」の「[EBS direct API のエンドポイント](https://docs.aws.amazon.com/general/latest/gr/ebs-service.html#ebs_direct_apis)」を参照してください。

**料金**  
EBS direct API と Amazon EC2 インスタンス間で、同一リージョン内の IPv4 エンドポイントを使用して直接転送されたデータについては、課金されません。ただし、 AWS PrivateLink エンドポイント、NAT ゲートウェイ、Amazon VPC トランジットゲートウェイなどの中間サービスがある場合は、関連するコストが請求されます。

## デュアルスタック (IPv4 および IPv6) エンドポイント
<a name="ipv6"></a>

デュアルスタックエンドポイントは、IPv4 と IPv6 トラフィックの両方をサポートします。デュアルスタックエンドポイントは、すべてのリージョンで利用できます。

IPv6 を使用するには、デュアルスタックエンドポイントを使用する必要があります。デュアルスタックエンドポイントにリクエストを行うと、エンドポイント URL は、ネットワークとクライアントが使用するプロトコルに応じて IPv6 または IPv4 アドレスに解決されます。

EBS direct API はリージョンのデュアルスタックエンドポイントのみをサポートしているため、エンドポイント名の一部としてリージョンを指定する必要があります。デュアルスタックエンドポイント名には、次の命名規則が使用されます。
+ `ebs.region.api.aws`

例えば、`eu-west-1` リージョンのデュアルスタックエンドポイント名は、`ebs.eu-west-1.api.aws` です。EBS direct API のエンドポイントのリストについては、「*Amazon Web Services 全般のリファレンス*」の「[EBS direct API のエンドポイント](https://docs.aws.amazon.com/general/latest/gr/ebs-service.html#ebs_direct_apis)」を参照してください。

**料金**  
EBS direct API と Amazon EC2 インスタンス間で、同一リージョン内のデュアルスタックエンドポイントを使用して直接転送されたデータについては、課金されません。ただし、 AWS PrivateLink エンドポイント、NAT ゲートウェイ、Amazon VPC トランジットゲートウェイなどの中間サービスがある場合は、関連するコストが請求されます。

## FIPS エンドポイント
<a name="fips"></a>

EBS direct 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 ]

次の例は、 AWS SDK for Goを使用して `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")
  })
  ```

------