EBS direct API 的服务端点

端点是作为 AWS Web 服务入口点的 URL。EBS 直接 API 支持以下端点类型：

• IPv4 端点

• 同时支持 IPv4 和 IPv6 的双堆栈端点

• FIPS 端点

当您发出请求时，您可以指定要使用的端点和区域。如果不指定端点，则默认使用 IPv4 端点。要使用不同的端点类型，您必须在请求中指定。有关如何执行此操作的示例，请参阅指定端点。

有关区域的更多信息，请参阅《Amazon EC2 用户指南》中的区域和可用区。有关 EBS 直接 API 的端点列表，请参阅 Amazon Web Services 一般参考 中的 EBS 直接 API 的端点。

IPv4 端点

IPv4 端点仅支持 IPv4 流量。IPv4 端点适用于所有区域。

EBS direct API 仅支持可用于发出请求的区域 IPv4 端点。您必须将区域指定为端点名称的一部分。端点名称使用以下命名约定：

• ebs.region.amazonaws.com

例如，要将您的请求定向到 us-east-2 IPv4 端点，您必须将 ebs.us-east-2.amazonaws.com 指定为端点。有关 EBS 直接 API 的端点列表，请参阅 Amazon Web Services 一般参考 中的 EBS 直接 API 的端点。

定价

在相同区域使用 IPv4 端点时，EBS 直接 API 和 Amazon EC2 实例之间直接传输数据是免费的。但是，如果存在中间服务，如 AWS PrivateLink 端点、NAT 网关或 Amazon VPC Transit Gateway，则需要向您收取相关费用。

双栈（IPv4 和 IPv6）端点

同时支持 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 的端点。

定价

在相同区域使用双堆栈端点时，EBS 直接 API 和 Amazon EC2 实例之间直接传输数据是免费的。但是，如果存在中间服务，如 AWS PrivateLink 端点、NAT 网关或 Amazon VPC Transit Gateway，则需要向您收取相关费用。

FIPS 端点

EBS 直接 API 为以下区域提供经过 FIPS 验证的 IPv4 和双堆栈（IPv4 和 IPv6）端点：

• us-east-1 – 美国东部（弗吉尼亚州北部）

• us-east-2 – 美国东部（俄亥俄州）

• us-west-1 – 美国西部（北加利福尼亚）

• us-west-2 – 美国西部（俄勒冈州）

• ca-central-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.UsEast1RegionID),
      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.UsEast1RegionID),
      Endpoint: aws.String("https://ebs.us-east-2.amazonaws.com")
  })