使用域名将流量路由到 Amazon API Gateway API
您可以使用 Amazon API Gateway 创建、发布、维护、监控和保护 API。除了存储在 AWS Cloud 中的数据以外,您还可以创建访问 AWS 服务或其他 Web 服务的 API。
用于将域流量路由到 API Gateway API 的方法取决于您创建的是区域 API Gateway 终端节点,还是边缘优化的 API Gateway 终端节点。
区域 API 终端节点:您创建将流量路由到区域 API 终端节点的 Route 53 别名记录。
边缘优化的 API 终端节点:您创建将流量路由到边缘优化 API 的 Route 53 别名记录。这会导致流量路由到与边缘优化 API 相关联的 CloudFront 分配。
别名记录是对 DNS 的 Route 53 扩展,类似于 CNAME 记录。有关别名记录和 CNAME 记录的比较,请参阅在别名记录和非别名记录之间进行选择。
注意
对于针对 API Gateway API 或其它 AWS 资源的别名查询,Route 53 不收费。
先决条件
要开始使用,您需要满足以下条件:
具有自定义域名的 API Gateway API(如 api.example.com),此域名与您要创建的 Route 53 记录的名称匹配。
有关更多信息,请参阅以下主题:
《Amazon API Gateway 开发人员指南》中的为 HTTP API 设置自定义域名。
《Amazon API Gateway 开发人员指南》中的为 REST API 设置自定义域名。
《Amazon API Gateway 开发人员指南》中的为 WebSocket API 设置自定义域名。
注册的域名。您可以使用 Amazon Route 53 作为您的域注册商,也可以使用其他注册商。
Route 53 用作域的 DNS 服务。如果您使用 Route 53 注册域名,我们会自动将 Route 53 配置为该域的 DNS 服务。
有关将 Route 53 用作域的 DNS 服务提供商的信息,请参阅 将 Amazon Route 53 作为现有域的 DNS 服务。
配置 Route 53 以将流量路由到 API Gateway 终端节点
要配置 Route 53 以将流量路由到 API Gateway 终端节点,请执行以下过程。
将流量路由到 API Gateway 终端节点
如果您使用相同账户创建了 Route 53 托管区域和终端节点,请跳到步骤 2。
如果您使用不同账户创建了托管区域和终端节点,请获取您要使用的自定义域名的目标域名:
登录到AWS Management Console并通过以下网址打开 API Gateway 控制台:https://console.aws.amazon.com/apigateway/
。 在导航窗格中,选择自定义域名。
选择您希望使用的自定义域名,并获取 API Gateway 域名的值。
通过以下网址打开 Route 53 控制台:https://console.aws.amazon.com/route53/
。 在导航窗格中,选择 Hosted zones(托管区域)。
选择具有要用于将流量路由到 API 的域名的托管区域的名称。
选择创建记录。
指定以下值:
重要
建议开启别名。对于未使用 Route 53 别名记录的域名,如果您使用的 VPC 启用了私有 DNS 来调用私有 API,则可能会遇到问题。私有 DNS 会覆盖 VPC 中的默认 DNS 解析行为,这可能会导致与外部 DNS 记录发生冲突。
- 路由策略
-
选择适用的路由策略。有关更多信息,请参阅 选择路由策略。
- 记录名称
-
输入要用于将流量路由到 API 的域名。
您要将流量路由到的 API 必须包含自定义域名(如 api.example.com),此域名与您要创建的 Route 53 记录的名称匹配。
- 别名
-
如果您使用 Quick create(快速创建)记录创建方法,请启用 Alias(别名)。
- 值/流量路由至
-
选择 Alias to API Gateway API(API Gateway API 的别名),然后选择终端节点所在的区域。
您为 Endpoint(终端节点)指定值的方式取决于您是使用相同 AWS 账户还是不同账户创建了托管区域和 API:
-
相同账户 - 目标域名的列表仅包含其自定义域名与您为 Record name(记录名称)指定的值匹配的 API。选择适用的值。
-
不同账户 - 输入您在此过程的步骤 1 中获得的值。
-
- 记录类型
-
请选择 A – IPv4 address(A – IPv4 地址)。
- Evaluate Target Health
-
要控制 DNS 故障转移,请配置自定义运行状况检查。有关示例,请参阅 API Gateway user guide(《API Gateway 用户指南》)中的 Configure custom health checks for DNS failover(为 DNS 故障转移配置自定义运行状况检查)。
-
选择创建记录。
更改通常在 60 秒内传播到所有 Route 53 服务器。传播完成后,您将能够使用在此步骤中创建的别名记录的名称将流量路由到 API。