OpenAPI 정의를 가져와 엣지 최적화 API 설정 - Amazon API Gateway

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

OpenAPI 정의를 가져와 엣지 최적화 API 설정

해당하는 API Gateway API 엔터티의 OpenAPI 정의를 지정하고 OpenAPI 정의를 API Gateway로 가져와 API Gateway에서 API를 설정할 수 있습니다.

다음 OpenAPI 정의는 PetStore 웹 사이트의 HTTP 엔드포인트와 통합된 GET / 메서드만 백엔드에 노출하고 응답을 반환하는 간단한 API를 설명합니다. 200 OK

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. https://console.aws.amazon.com/apigateway에서 API Gateway 콘솔에 로그인합니다.

  2. API 생성을 선택한 다음 REST API에 대해 가져오기를 선택합니다.

  3. 앞서 파일에 OpenAPI 정의를 저장한 경우, 파일 선택을 선택합니다. OpenAPI 정의를 복사하여 가져온 텍스트 편집기에 붙여 넣을 수도 있습니다.

  4. API 엔드포인트 유형에서 엣지 최적화를 선택합니다.

  5. OpenAPI 정의를 가져오려면 API 생성을 선택합니다.

를 사용하여 OpenAPI 정의를 가져오려면 OpenAPI 정의를 파일에 저장한 후 다음 명령을 실행합니다. 이때 해당 영역을 사용하고 절대 OpenAPI 파일 경로가 다음과 같다고 가정합니다. AWS CLIus-west-2 file:///path/to/API_OpenAPI_template.json

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