在 API Gateway 中开发 HTTP API

本节提供有关开发 API Gateway API 时所需的 API Gateway 功能的详细信息。

在开发 API Gateway API 时，您可以决定 API 的许多特征。这些特征取决于 API 的使用案例。例如，您可能希望仅允许某些客户端调用您的 API，或者您可能希望它对所有人都可用。您可能需要 API 调用来执行 Lambda 函数、进行数据库查询或调用应用程序。

主题

• 创建 HTTP API
• 使用 HTTP API 的路由
• 控制和管理对 API Gateway 中 HTTP API 的访问
• 为 HTTP API 配置集成
• 为 HTTP API 配置 CORS
• 转换 API 请求和响应
• 将 OpenAPI 定义用于 HTTP API

创建 HTTP API

要创建功能 API，您必须至少有一个路由、集成、阶段和部署。

以下示例显示如何创建具有 AWS Lambda 或 HTTP 集成、路由和默认阶段（配置为自动部署更改）的 API。

本指南以您已熟悉 API Gateway 和 Lambda 为前提。如需更详细的指南，请参阅开始使用 API Gateway。

使用 创建 HTTP APIAWS Management Console

1. 打开 API Gateway 控制台。

2. 选择 Create API (创建 API)。

3. 在 HTTP API 下，选择 Build (构建)。

4. 选择 Add integration (添加集成)，然后选择一个 AWS Lambda 函数或输入 HTTP 终端节点。

5. 对于 Name (名称)，输入 API 的名称。

6. 选择 Review and create。

7. 选择创建。

现在，您的 API 已准备好，可进行调用。您可以通过在浏览器中输入其调用 URL 或使用 Crul 来测试您的 API。

curl https://api-id.execute-api.us-east-2.amazonaws.com

使用AWS CLI 创建 HTTP API

您可以使用“快速创建”功能，创建具有 Lambda 或 HTTP 集成、默认“捕获全部”路由和默认阶段（配置为自动部署更改）的 API。以下命令使用快速创建来创建与后端上的 Lambda 函数集成的 API。

注意

要调用 Lambda 集成，API Gateway 必须具有所需的权限。您可以使用基于资源的策略或 IAM 角色，为 API Gateway 授予权限以调用 Lambda 函数。如需了解更多信息，请参阅 AWS Lambda 开发人员指南中的 AWS Lambda 权限。

aws apigatewayv2 create-api --name my-api --protocol-type HTTP --target arn:aws:lambda:us-east-2:123456789012:function:function-name

现在，您的 API 已准备好，可进行调用。您可以通过在浏览器中输入其调用 URL 或使用 Crul 来测试您的 API。

curl https://api-id.execute-api.us-east-2.amazonaws.com