View a markdown version of this page

使用域名将流量路由到 Amazon API Gateway API - Amazon Route 53
先决条件配置 Route 53 以将流量路由到 API Gateway 终端节点

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

使用域名将流量路由到 Amazon API Gateway API

您可以使用 Amazon API Gateway 创建、发布、维护、监控和保护 API。除了存储在 AWS 云中的数据外，您还可以创建 API 来访问 AWS 服务或其他 Web 服务。

无论您创建了区域 API 网关终端节点还是边缘优化的 API 网关终端节点，用于将域流量路由到 API 网关 API 的方法都是相同的。如果您创建私有 API Gateway 端点，则过程略有不同。

  • 区域 API 终端节点：您可以创建 Route 53 别名记录，将流量路由到区域 API 终端节点。

  • Edge-optimized API 终端节点：您可以创建 Route 53 别名记录，将流量路由到边缘优化的 API。这会导致流量路由到与边缘优化 API 相关的 CloudFront 发行版。

  • 私有 API 端点：您创建一个 Route 53 别名记录，该记录使用私有托管区中 API Gateway 的接口 VPC 端点将流量路由到您的私有 API 端点。

别名记录是对 DNS 的 Route 53 扩展，类似于 CNAME 记录。有关别名记录和 CNAME 记录的比较，请参阅在别名记录和非别名记录之间进行选择。

注意

Route 53 不对 API 网关 API 或其他 AWS 资源的别名查询收费。

先决条件

要开始使用，您需要满足以下条件：

配置 Route 53 以将流量路由到 API Gateway 终端节点

要配置 Route 53 以将流量路由到 API Gateway 终端节点，请执行以下过程。

Custom domain names for public APIs

以下程序描述如何针对公有 API 的自定义域名将流量路由到 API Gateway 端点。

将流量路由到 API Gateway 端点

  1. 如果您使用相同账户创建了 Route 53 托管区和端点，请跳到步骤 2。

    如果您使用不同账户创建了托管区和端点，请获取您要使用的自定义域名的目标域名：

    1. 登录 AWS 管理控制台 并打开 API 网关控制台，网址为https://console.aws.amazon.com/apigateway/。

    2. 在导航窗格中，选择自定义域名。

    3. 选择您希望使用的自定义域名，并获取 API Gateway 域名的值。

  2. 在以下位置打开 Route 53 控制台https://console.aws.amazon.com/route53/。

  3. 在导航窗格中，选择 Hosted zones（托管区域）。

  4. 选择具有要用于将流量路由到 API 的域名的托管区域的名称。

  5. 选择创建记录。

  6. 指定以下值：

    重要

    建议开启别名。对于未使用 Route 53 别名记录的域名，如果您使用的 VPC 启用了私有 DNS 来调用私有 API，则可能会遇到问题。私有 DNS 会覆盖 VPC 中的默认 DNS 解析行为，这可能会导致与外部 DNS 记录发生冲突。

    路由策略

    选择适用的路由策略。有关更多信息，请参阅 选择路由策略。

    记录名称

    输入要用于将流量路由到 API 的域名。

    您要将流量路由到的 API 必须包含自定义域名（如 api.example.com），此域名与您要创建的 Route 53 记录的名称匹配。

    Alias

    如果您使用 Quick create（快速创建）记录创建方法，请启用 Alias（别名）。

    Value/Route 流量到

    选择 Alias to API Gateway API（API Gateway API 的别名），然后选择终端节点所在的区域。

    如何指定 Endpoint 的值取决于您是使用相同的 AWS 账户还是不同的账户创建托管区域和 API：

    • 相同账户 - 目标域名的列表仅包含其自定义域名与您为 Record name（记录名称）指定的值匹配的 API。选择适用的值。

    • 不同账户 - 输入您在此过程的步骤 1 中获得的值。

    记录类型

    请选择 A – IPv4 address（A – IPv4 地址）。

    评估目标运行状况

    要控制 DNS 故障转移，请配置自定义运行状况检查。有关示例，请参阅 API Gateway user guide（《API Gateway 用户指南》）中的 Configure custom health checks for DNS failover（为 DNS 故障转移配置自定义运行状况检查）。

  7. 选择创建记录。

    更改通常在 60 秒内传播到所有 Route 53 服务器。传播完成后，您将能够使用在此步骤中创建的别名记录的名称将流量路由到 API。

Custom domain names for private APIs

以下程序描述如何针对私有 API 的自定义域名将流量路由到 API Gateway 端点。

将流量路由到 API Gateway 端点

  1. 在以下位置打开 Route 53 控制台https://console.aws.amazon.com/route53/。

  2. 在导航窗格中，选择 Hosted zones（托管区域）。

  3. 选择具有要用于将流量路由到 API 的域名的私有托管区的名称。

  4. 选择创建记录。

  5. 指定以下值：

    路由策略

    选择适用的路由策略。有关更多信息，请参阅 选择路由策略。

    记录名称

    输入要用于将流量路由到 API 的域名。

    您要将流量路由到的 API 必须包含自定义域名（如 api.example.com），此域名与您要创建的 Route 53 记录的名称匹配。

    Alias

    开启别名。

    Value/Route 流量到

    选择 VPC 端点的别名。选择端点所在的区域，然后选择 VPC 端点。

    记录类型

    如果您为 VPC 端点使用 IPv6，请创建 AAAA 记录类型。如果您为 VPC 端点使用双堆栈，请创建 AAAA 和 A 记录类型。

    评估目标运行状况

    要控制 DNS 故障转移，请配置自定义运行状况检查。有关示例，请参阅 API Gateway user guide（《API Gateway 用户指南》）中的 Configure custom health checks for DNS failover（为 DNS 故障转移配置自定义运行状况检查）。

  6. 选择创建记录。

    更改通常在 60 秒内传播到所有 Route 53 服务器。传播完成后，您将能够使用在此步骤中创建的别名记录的名称将流量路由到 API。