在 API Gateway 中通过自定义域名将流量发送到 API - Amazon API Gateway
何时使用路由规则在路由规则与 API 映射之间选择
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

在 API Gateway 中通过自定义域名将流量发送到 API

在为自定义域名配置路由模式时，可以设置如何将传入流量定向到 API。可以使用路由规则、API 映射或路由规则和 API 映射将流量发送到 API。下一节说明何时使用路由规则、何时使用 API 映射以及如何为自定义域名设置路由模式。

何时使用路由规则

使用路由规则时，可以将与特定条件相匹配的传入请求定向到特定的 REST API 阶段。例如，如果规则包含标头 version:v1 和基本路径 /users，则此规则可以将请求路由到 users REST API 的 production 阶段。使用路由规则来创建高级动态路由拓扑，以支持诸如 A/B 测试或新版本 API 的使用不断增加等使用案例。

我们建议在将流量定向到 REST API 时，对自定义域名使用路由规则。可以使用路由规则来重新创建任何 API 映射。有关更多信息，请参阅 使用路由规则重新创建 API 映射。

对于 REST API，还可以结合使用路由规则和 API 映射。当您结合使用路由规则和 API 映射时，API Gateway 始终在评估任何 API 映射之前评估路由规则。结合使用路由规则和 API 映射来迁移您当前的自定义域名或探索路由规则。

路由规则注意事项

以下注意事项可能会影响您对路由规则的使用：

  • 不支持将 WebSocket 或 HTTP API 作为路由规则的目标 API。

  • 如果自定义域名具有到 REST 和 HTTP API 的 API 映射，则不支持路由规则。

  • 可以为私有自定义域创建指向私有 REST API 的路由规则。可以为公有自定义域创建指向区域或边缘优化 API 的路由规则。

  • 无法为公有自定义域创建指向私有 API 的路由规则。无法为私有自定义域名创建指向公有 API 的路由规则。

在路由规则与 API 映射之间选择

我们建议您在可能的情况下使用路由规则。仅使用 API 映射将流量发送到 HTTP 或 WebSocket API。