Amazon API Gateway
Developer Guide

Set up an Edge-Optimized API by Importing OpenAPI Definitions

You can set up an API in API Gateway by specifying OpenAPI definitions of appropriate API Gateway API entities and importing the OpenAPI definitions into API Gateway.

The following OpenAPI definitions describe the simple API, exposing only the GET / method integrated with an HTTP endpoint of the PetStore website in the backend, and returning a 200 OK response.

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" } } } } }

The following procedure describes how to import these OpenAPI definitions into API Gateway using the API Gateway console.

To import the simple OpenAPI definitions using the API Gateway console

  1. Sign in to the API Gateway console.

  2. Choose Create API.

  3. Choose Import from OpenAPI.

  4. If you saved the preceding OpenAPI definitions in a file, choose Select OpenAPI File. You can also copy the OpenAPI definitions and paste them into the import text editor.

  5. Choose Import to finish importing the OpenAPI definitions.

To import the OpenAPI definitions using the API Gateway REST API, call the restapi:import action, supplying the preceding OpenAPI definitions as the payload. For more information, see the example in the Remarks section of the restapi:import topic.

To import the OpenAPI definitions using the AWS CLI, save the OpenAPI definitions into a file and then run the following command, assuming that you use the us-west-2 region and the absolute OpenAPI file path is file:///path/to/API_OpenAPI_template.json:

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