EBS 直接 API 服务端点 - Amazon EBS
IPv4 端点双栈（IPv4 和 IPv6）端点FIPS 端点指定端点

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

EBS 直接 API 服务端点

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

  • IPv4 端点

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

  • FIPS 端点

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

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

IPv4 端点

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

如果您指定通用端点 ebs.amazonaws.com，则我们将端点用于 us-east-1。要使用其他区域，请指定其关联端点。例如，如果您指定 ebs.us-east-2.amazonaws.com 为端点，我们会将您的请求定向到 us-east-2 端点。

IPv4 端点名称使用以下命名约定：

  • ebs.region.amazonaws.com

例如，us-west-1 区域的 IPv4 端点名称是 ebs.us-west-1.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")
})