教程：构建私有 REST API

打开 AWS CloudFormation 控制台，地址：https://console.aws.amazon.com/cloudformation。

选择创建堆栈，然后选择使用新资源(标准)。

对于指定模板，选择上传模板文件。

选择您下载的模板。

选择下一步。

对于堆栈名称，输入 private-api-tutorial，然后选择下一步。

对于配置堆栈选项，请选择下一步。

对于功能，请确认 AWS CloudFormation 可以在您的账户中创建 IAM 资源。

选择提交。

通过以下网址登录到 Amazon API Gateway 控制台：https://console.aws.amazon.com/apigateway。

选择创建 API，然后为 REST API 选择构建。

对于 API Name (API 名称)，请输入 private-api-tutorial。

对于 API 端点类型，选择私有。

对于 VPC 端点 ID，请输入 AWS CloudFormation 堆栈的输出中的 VPC 端点 ID。

选择创建 API。

通过以下网址登录到 Amazon API Gateway 控制台：https://console.aws.amazon.com/apigateway。

选择 API。

选择 / 资源，然后选择创建方法。

对于方法类型，选择 GET。

对于集成类型，选择 Lambda 函数。

打开 Lambda 代理集成。通过 Lambda 代理集成，API Gateway 将具有定义结构的事件发送到 Lambda，并将响应从您的 Lambda 函数转换为 HTTP 响应。

对于 Lambda 函数，请选择您在步骤 1 中使用 AWS CloudFormation 模板创建的函数。函数的名称以 private-api-tutorial 为开头。

选择创建方法。

通过以下网址登录到 Amazon API Gateway 控制台：https://console.aws.amazon.com/apigateway。

选择 API。

选择资源策略，然后选择创建策略。

输入以下策略。使用来自您 ‭AWS CloudFormation 堆栈的 ‭输出‭ 中的 VPC 端点 ID 替换 vpceID‬。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Principal": "*",
            "Action": "execute-api:Invoke",
            "Resource": "execute-api:/*",
            "Condition": {
                "StringNotEquals": {
                    "aws:sourceVpce": "vpceID"
                }
            }
        },
        {
            "Effect": "Allow",
            "Principal": "*",
            "Action": "execute-api:Invoke",
            "Resource": "execute-api:/*"
        }
    ]
}

选择 Save changes（保存更改）。

通过以下网址登录到 Amazon API Gateway 控制台：https://console.aws.amazon.com/apigateway。

选择 API。

选择部署 API。

对于阶段，选择新建阶段。

对于阶段名称，输入 test。

（可选）对于描述，输入描述。

选择 Deploy (部署)。

通过以下网址登录到 Amazon API Gateway 控制台：https://console.aws.amazon.com/apigateway。

选择 API。

在主导航窗格中，选择阶段，然后选择测试阶段。

在阶段详细信息下，选择复制图标以复制您 API 的调用 URL。URL 类似于 https://abcdef123.execute-api.us-west-2.amazonaws.com/test。您在步骤 1 中创建的 VPC 端点启用了私有 DNS，因此您可以使用提供的 URL 调用 API。

使用 curl 尝试从 VPC 外部调用 API。

curl https://abcdef123.execute-api.us-west-2.amazonaws.com/test

Curl 表示您的 API 的端点无法解析。如果您收到其他响应，请返回步骤 2，并确保为 API 的端点类型选择私有。

curl: (6) Could not resolve host: abcdef123.execute-api.us-west-2.amazonaws.com/test

通过以下网址打开 Amazon EC2 控制台：https://console.aws.amazon.com/ec2/。

选择实例。

选择您在步骤 1 中使用 AWS CloudFormation 模板创建的名为 private-api-tutorial 的实例。

选择连接，然后选择会话管理器。

选择连接可启动与实例的基于浏览器的会话。

在会话管理器会话中，使用 curl 调用 API。您可以调用 API，因为您在 Amazon VPC 中使用的是实例。

curl https://abcdef123.execute-api.us-west-2.amazonaws.com/test

验证您得到了回复 Hello from Lambda!。

通过以下网址登录到 Amazon API Gateway 控制台：https://console.aws.amazon.com/apigateway。

在 API 页面上，选择一个 API。选择 API 操作，选择删除 API，然后确认您的选择。

打开 AWS CloudFormation 控制台，地址：https://console.aws.amazon.com/cloudformation。

选择您的 AWS CloudFormation 堆栈。

选择删除，然后确认您的选择。