Amazon API Gateway
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

通过导入 OpenAPI 定义设置边缘优化的 API

通过指定相应 API Gateway API 实体的 OpenAPI 定义并将 OpenAPI 定义导入 API Gateway,您可以在 API Gateway 中设置 API。

以下 OpenAPI 定义描述了一个简单 API,该 API 仅公开与后端中 PetStore 网站的 HTTP 终端节点集成的 GET / 方法,并返回 200 OK 响应。

OpenAPI 2.0
OpenAPI 2.0
{ "swagger": "2.0", "info": { "title": "Simple PetStore (OpenAPI)" }, "schemes": [ "https" ], "paths": { "/pets": { "get": { "responses": { "200": { "description": "200 response" } }, "x-amazon-apigateway-integration": { "responses": { "default": { "statusCode": "200" } }, "uri": "http://petstore-demo-endpoint.execute-api.com/petstore/pets", "passthroughBehavior": "when_no_match", "httpMethod": "GET", "type": "http" } } }, "/pets/{petId}": { "get": { "parameters": [ { "name": "petId", "in": "path", "required": true, "type": "string" } ], "responses": { "200": { "description": "200 response" } }, "x-amazon-apigateway-integration": { "responses": { "default": { "statusCode": "200" } }, "requestParameters": { "integration.request.path.id": "method.request.path.petId" }, "uri": "http://petstore-demo-endpoint.execute-api.com/petstore/pets/{id}", "passthroughBehavior": "when_no_match", "httpMethod": "GET", "type": "http" } } } } }

以下过程介绍了如何使用 API Gateway 控制台将这些 OpenAPI 定义导入到 API Gateway 中。

使用 API Gateway 控制台导入简单的 OpenAPI 定义

  1. 登录到 API Gateway 控制台。

  2. 选择 Create API (创建 API)

  3. 选择 Import from OpenAPI (从 OpenAPI 中导入)

  4. 如果您已将上述 OpenAPI 定义保存在文件中,请选择 Select OpenAPI File (选择 OpenAPI 文件)。此外,您还可以复制 OpenAPI 定义并将其粘贴到导入文本编辑器中。

  5. 选择导入以便完成 OpenAPI 定义的导入。

要使用 AWS CLI 导入 OpenAPI 定义,请将 OpenAPI 定义保存到一个文件中,然后运行以下命令(假设您使用 us-west-2 区域,OpenAPI 文件的绝对路径为 file:///path/to/API_OpenAPI_template.json):

aws apigateway import-rest-api --body 'file:///path/to/API_OpenAPI_template.json' --region us-west-2