EBS direct API 用のサービスエンドポイント - Amazon EBS
IPv4 エンドポイントデュアルスタック (IPv4 および IPv6) エンドポイントFIPS エンドポイントエンドポイントの指定

EBS direct API 用のサービスエンドポイント

エンドポイントは、AWS ウェブサービスのエントリポイントとなる URL です。EBS direct API は以下のエンドポイントタイプをサポートします。

  • IPv4 エンドポイント

  • IPv4 と IPv6 の両方をサポートするデュアルスタックのエンドポイント

  • FIPS エンドポイント

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

リージョンの詳細については、「Amazon EC2 ユーザーガイド」の「リージョンとアベイラビリティーゾーン」を参照してください。EBS direct API のエンドポイントのリストについては、「Amazon Web Services 全般のリファレンス」の「EBS direct API のエンドポイント」を参照してください。

IPv4 エンドポイント

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 のエンドポイント」を参照してください。

料金

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

デュアルスタック (IPv4 および IPv6) エンドポイント

デュアルスタックエンドポイントは、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 のエンドポイント」を参照してください。

料金

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

FIPS エンドポイント

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 エンドポイント」を参照してください。

エンドポイントの指定

このセクションでは、リクエストを行うときにエンドポイントを指定する方法を例で示します。

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")
})