EBS 直接 API 服务端点 - Amazon EBS
IPv4 端点双栈（IPv4 和 IPv6）端点指定端点
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

EBS 直接 API 服务端点

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

  • IPv4 端点

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

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

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

IPv4 端点

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

EBS 直接 API 仅支持可用于发出请求的区域 IPv4 终端节点。您必须在终端节点名称中指定区域。端点名称使用以下命名约定：

  • ebs.region.amazonaws.com.cn

例如，北京区域的 IPv4 端点名称是 ebs.cn-northwest-1.amazonaws.com.cn。

定价

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

双栈（IPv4 和 IPv6）端点

同时支持 IPv4 和 IPv6 流量的双堆栈端点。双堆栈端点适用于所有区域。

要使用 IPv6，您必须使用双堆栈端点。当您向双堆栈端点发出请求时，端点 URL 解析为 IPv6 或 IPv4 地址，具体取决于您的网络和客户端使用的协议。

EBS 直接 API 只支持区域双堆栈端点，这意味着，您必须将区域指定为端点名称的一部分。双堆栈端点名称使用以下命名约定：

  • ebs.region.api.amazonwebservices.com.cn

例如，北京区域的双堆栈端点名称为 ebs.cn-northwest-1.api.aws。

定价

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

指定端点

本节提供了一些在发出请求时如何指定端点的示例。

Amazon CLI

以下示例显示如何使用 Amazon CLI为北京区域指定端点。

  • 双堆栈

    aws ebs list-snapshot-blocks --snapshot-id snap-0987654321 --starting-block-index 1000 --endpoint-url https://ebs.cn-northwest-1.api.amazonwebservices.com.cn

  • IPv4

    aws ebs list-snapshot-blocks --snapshot-id snap-0987654321 --starting-block-index 1000 --endpoint-url https://ebs.cn-northwest-1.amazonaws.com.cn
Amazon SDK for Java 2.x

以下示例显示如何使用 Amazon SDK for Java 2.x为北京区域指定端点。

  • 双堆栈

    AwsClientBuilder.EndpointConfiguration config = new AwsClientBuilder.EndpointConfiguration("https://ebs.cn-northwest-1.api.amazonwebservices.com.cn", "cn-northwest-1");
AmazonEBS ebs = AmazonEBSClientBuilder.standard()
    .withEndpointConfiguration(config)
    .build();

  • IPv4

    AwsClientBuilder.EndpointConfiguration config = new AwsClientBuilder.EndpointConfiguration("https://ebs.cn-northwest-1.amazonaws.com.cn", "cn-northwest-1");
AmazonEBS ebs = AmazonEBSClientBuilder.standard()
    .withEndpointConfiguration(config)
    .build();
Amazon SDK for Go

以下示例显示如何使用 Amazon SDK for Go为北京区域指定端点。

  • 双堆栈

    sess := session.Must(session.NewSession())
svc := ebs.New(sess, &aws.Config{
    Region: aws.String(endpoints.CnNorth1RegionID),
    Endpoint: aws.String("https://ebs.cn-northwest-1.api.amazonwebservices.com.cn")
})

  • IPv4

    sess := session.Must(session.NewSession())
svc := ebs.New(sess, &aws.Config{
    Region: aws.String(endpoints.CnNorth1RegionID),
    Endpoint: aws.String("https://ebs.cn-northwest-1.amazonaws.com.cn")
})