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

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

Amazon API Gateway 允许您创建、发布、维护、监控和保护 API。您可以创建能够访问 AWS 服务、其他 Web 服务以及存储在 AWS 云中的数据的 API。

用于将域流量路由到 API 网关 API 的方法取决于您创建的是区域 API 网关 终端节点,还是边缘优化的 API 网关 终端节点。

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

  • 边缘优化的 API 终端节点:您创建一个 Route 53 别名记录,以将流量路由到与边缘优化 API 关联的 CloudFront 分配。

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

注意

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

先决条件

在开始之前,您需要满足以下条件:

  • 具有自定义域名的 API 网关 API(如 api.example.com),此域名与您要创建的 Route 53 记录的名称匹配。

  • 注册的域名。您可以使用 Amazon Route 53 作为您的域注册商,也可以使用其他注册商。

  • Route 53 用作域的 DNS 服务。如果您使用 Route 53 注册域名,我们会自动将 Route 53 配置为该域的 DNS 服务。

    有关将 Route 53 用作域的 DNS 服务提供商的信息,请参阅将 Amazon Route 53 作为现有域的 DNS 服务

配置 Route 53 以将流量路由到区域 API 网关 终端节点

要配置 Route 53 以将流量路由到区域 API 网关 终端节点,请执行以下过程。

将流量路由到区域 API 网关 终端节点

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

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

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

    2. 在导航窗格中,选择 Custom domain names (自定义域名)

    3. 对于您希望使用的自定义域名,获取 Domain name (域名) 的值。

  2. 通过以下网址打开 Route 53 控制台:https://console.aws.amazon.com/route53/

  3. 在导航窗格中,选择 Hosted Zones

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

  5. 选择 Create Record Set

  6. 指定以下值:

    名称

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

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

    类型

    选择 A – IPv4 地址

    别名

    选择

    别名目标

    您为 Alias Target (别名目标) 指定值的方式取决于您是使用相同 AWS 账户还是不同账户创建了托管区域和 API:

    • 相同账户 – 选择列表,并找到类别 API 网关 API。目标域名的列表仅包含其自定义域名与您为 Name (名称) 指定的值匹配的 API。选择适用的值。

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

    路由策略

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

    Evaluate Target Health

    接受默认值 No

  7. 选择 Create

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

配置 Route 53 以将流量路由到边缘优化的 API 网关 终端节点

要配置 Route 53 以将流量路由到边缘优化的 API 网关 终端节点,请执行以下过程。

将流量路由到边缘优化的 API 网关 终端节点

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

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

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

    2. 在导航窗格中,选择 Custom domain names (自定义域名)

    3. 对于您希望使用的自定义域名,获取 Domain name (域名) 的值。

  2. 通过以下网址打开 Route 53 控制台:https://console.aws.amazon.com/route53/

  3. 在导航窗格中,选择 Hosted Zones

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

  5. 选择 Create Record Set

  6. 指定以下值:

    名称

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

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

    类型

    选择 A – IPv4 地址

    别名

    选择

    别名目标

    您为 Alias Target (别名目标) 指定值的方式取决于您是使用相同 AWS 账户还是不同账户创建了托管区域和 API:

    • 相同账户 – 选择列表,并找到类别 CloudFront distributions (CloudFront 分配)。目标域名的列表仅包含其自定义域名与您为 Name (名称) 指定的值匹配的分配。选择适用的值。

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

    路由策略

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

    Evaluate Target Health

    接受默认值 No

  7. 选择 Create

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