如何CNAME到Amazon API网关端点

在云计算和网络架构中，使用CNAME（Canonical Name）记录是一种常见的方法，用于将一个域名指向另一个域名。在Amazon Web Services（AWS）中，可以将自定义域名通过CNAME记录指向Amazon API Gateway的端点。以下是此过程的步骤：

步骤1: 在Amazon API Gateway中创建或配置API

首先，确保您的API已在Amazon API Gateway中配置好。如果您是新手，可以通过AWS管理控制台创建一个新的API。

步骤2: 部署您的API

部署API到一个stage，例如 prod 或 dev。部署后，API Gateway会为您的API生成一个默认的执行URL，格式类似于：

shell
https://{api-id}.execute-api.{region}.amazonaws.com/{stage}

步骤3: 创建自定义域名

1. 在Amazon API Gateway控制台中，选择或创建您想要使用的API。
2. 转到"自定义域名"部分。
3. 点击“创建”或“添加自定义域名”。
4. 输入您希望API使用的域名，例如 api.example.com。
5. 选择安全证书。您可以选择从AWS Certificate Manager (ACM) 中导入一个SSL/TLS证书，或者上传您自己的证书。
6. 完成配置并保存。

步骤4: 创建基于路径的路由（可选）

如果您的API需要支持多个路径，您可以在自定义域名配置中设置路径映射（path mapping）。这允许不同的路径指向API Gateway中的不同API或不同的stages。

步骤5: 更新DNS记录

1. 转到您管理域名的DNS提供商（如GoDaddy、Google Domains等）。
2. 找到DNS管理页面，并为您的自定义域名添加一条CNAME记录。
3. 将CNAME的值设置为API Gateway为您的自定义域名提供的目标域名，例如：

shell
api.example.com CNAME {custom-domain}.execute-api.{region}.amazonaws.com

请注意，这个指向并不是直接指向API的默认执行URL，而是指向在API Gateway中配置的自定义域名的AWS端点。

示例

假设您有一个在API Gateway上的天气查询API，并且想要通过 weather.example.com 来访问。您已创建并部署了API，您的默认执行URL可能是：

shell
https://123abc.execute-api.us-west-2.amazonaws.com/prod

您可以为此API设置一个自定义域名 weather.example.com，并通过您的DNS提供商添加一条CNAME记录，如下所设：

shell
weather.example.com CNAME weather.example.com.execute-api.us-west-2.amazonaws.com

这样，当用户访问 weather.example.com 时，实际上他们访问的是您在Amazon API Gateway上配置的API。