REST API 통합 설정 - Amazon API Gateway

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

REST API 통합 설정

API 메서드를 설정한 후 이를 백엔드의 엔드포인트와 통합해야 합니다. 백엔드 엔드포인트는 통합 엔드포인트로도 참조되며, Lambda 함수, HTTP 웹 페이지 또는 AWS 서비스 작업일 수 있습니다.

API 메서드와 마찬가지로 API 통합에는 통합 요청 및 통합 응답이 있습니다. 통합 요청은 백엔드가 수신하는 HTTP 요청을 캡슐화합니다. 클라이언트가 제출하는 메서드 요청과는 다를 수도 있고, 다르지 않을 수도 있습니다. 통합 응답은 백엔드에서 반환되는 출력을 캡슐화하는 HTTP 응답입니다.

통합 요청 설정에 수반되는 작업: 클라이언트가 제출한 메서드 요청을 백엔드로 전달하는 방식을 구성, 필요한 경우 요청 데이터를 통합 요청 데이터로 변환하는 방식을 구성, 호출할 Lambda 함수 지정, 수신 요청을 전송할 HTTP 서버 지정, 또는 호출할 AWS 서비스 작업 지정.

통합 응답을 설정하려면(비 프록시 통합에만 적용) 백엔드에서 반환된 결과를 특정 상태 코드의 메서드 응답에 전달하는 방식을 구성하고, 지정된 통합 응답 파라미터를 사전 구성된 메서드 응답 파라미터로 변환하는 방식을 구성하고, 지정된 본문 매핑 템플릿에 따라 통합 응답 본문을 메서드 응답 본문으로 매핑하는 방식을 구성해야 합니다.

프로그램에 따라 통합 요청은 Integration 리소스에 의해 캡슐화되고 통합 응답은 API Gateway의 IntegrationResponse 리소스에 의해 캡슐화됩니다.

통합 요청을 설정하려면 Integration 리소스를 생성한 후 이를 사용해 통합 엔드포인트 URL을 구성합니다. 그 다음에 백엔드에 액세스할 수 있는 IAM 권한을 설정하고 매핑을 지정하여 수신 요청 데이터를 백엔드로 전달하기 전에 변환합니다. 비프록시 통합에 대해 통합 응답을 설정하려면 IntegrationResponse 리소스를 생성한 후 이를 사용하여 대상 메서드 응답을 설정합니다. 그 다음에 백엔드 출력을 메서드 응답으로 매핑하는 방식을 구성합니다.