API Gateway API 통합 유형 선택

작업 중인 통합 엔드포인트의 유형과 데이터가 통합 엔드포인트로(부터) 전달되는 방식에 따라 API 통합 유형을 선택합니다. Lambda 함수의 경우 Lambda 프록시 통합 또는 Lambda 사용자 지정 통합이 있을 수 있습니다. HTTP 엔드포인트의 경우에는 HTTP 프록시 통합 또는 HTTP 사용자 지정 통합이 있을 수 있습니다. AWS 서비스 작업의 경우에는 비프록시 유형의 AWS 통합만 있습니다. API Gateway도 모의 통합을 지원하는데, 이 경우 API Gateway는 메서드 요청에 응답하기 위한 통합 엔드포인트의 역할을 합니다.

Lambda 사용자 지정 통합은 AWS 통합의 특수 사례로서, 이 경우 통합 엔드포인트는 Lambda 서비스의 function-invoking 작업에 해당합니다.

프로그래밍 방식으로 Integration 리소스의 type 속성을 설정하여 통합 유형을 선택합니다. Lambda 프록시 통합의 경우, 그 값은 AWS_PROXY입니다. Lambda 사용자 지정 통합 및 기타 모든 AWS 통합의 경우에는 AWS입니다. HTTP 프록시 통합 및 HTTP 통합의 경우에는 그 값이 각각 HTTP_PROXY 및 HTTP입니다. 모의 통합의 경우 type 값은 MOCK입니다.

Lambda 프록시 통합은 단일 Lambda 함수를 사용하여 간소화된 통합 설정을 지원합니다. 이 설정은 간단하며 기존 설정을 손상하지 않고 백엔드와 함께 진화할 수 있습니다. 이러한 이유로 Lambda 함수와의 통합을 적극 권장합니다.

이와 대조적으로 Lambda 사용자 지정 통합을 사용하면 입력 및 출력 데이터 형식의 유사한 요구 사항이 있는 다양한 통합 엔드포인트에 대해 구성된 매핑 템플릿을 재사용할 수 있습니다. 이 설정은 더 복잡하며 더 고급 애플리케이션 시나리오에 권장됩니다.

이와 마찬가지로 HTTP 프록시 통합에는 간소화된 통합 설정이 있으며 기존 설정을 손상하지 않고 백엔드와 함께 진화할 수 있습니다. HTTP 사용자 지정 통합은 설정하기가 더 복잡하지만 다른 통합 엔드포인트에 대해 구성된 매핑 템플릿을 재사용할 수 있습니다.

다음 목록은 지원되는 통합 유형을 요약한 것입니다.

• AWS: 이 통합 유형을 사용하면 API에서 AWS 서비스 작업을 공개할 수 있습니다. AWS 통합의 경우, 통합 요청과 통합 응답을 모두 구성하고 메서드 요청에서 통합 요청으로, 통합 응답에서 메서드 응답으로 필수적인 데이터 매핑을 설정해야 합니다.

• AWS_PROXY: 이러한 유형의 통합을 사용해 유연하고 다목적이며 간소화된 통합 설정으로 API 메서드가 Lambda 함수 호출 작업에 통합되도록 할 수 있습니다. 이러한 통합은 통합된 Lambda 기능과 클라이언트 간의 직접적인 상호 작용에 의존합니다.

  Lambda 프록시 통합으로도 알려진 이러한 유형의 통합에서는 통합 요청 또는 통합 응답을 설정하지 않습니다. API Gateway는 클라이언트로부터 입력으로 수신되는 요청을 백엔드 Lambda 함수로 전달합니다. 통합된 Lambda 함수는 이 형식의 입력을 받아들여 그 입력을 요청 헤더, URL 경로 변수, 쿼리 문자열 파라미터 및 적용 가능한 본문 등 사용 가능한 모든 소스로부터 구문 분석합니다. 이 함수는 이 출력 형식에 따라 결과를 반환합니다.

  이것은 API Gateway를 통해 Lambda 함수를 호출할 때 선호되는 통합 유형이며 함수 호출 작업 외의 Lambda 작업을 포함한 기타 모든 AWS 서비스 작업에는 적용할 수 없습니다.

• HTTP: 이 통합 유형을 사용하면 API에서 백엔드의 HTTP 엔드포인트를 공개할 수 있습니다. HTTP 사용자 지정 통합으로도 알려진 HTTP 통합에서는 통합 요청과 통합 응답을 둘 다 설정해야 합니다. 메서드 요청에서 통합 요청으로, 그리고 통합 응답에서 메서드 응답으로 필수적인 데이터 매핑을 설정해야 합니다.

• HTTP_PROXY: HTTP 프록시 통합을 사용하여 클라이언트는 단일 API 메서드에서 간소화된 통합 설정을 통해 백엔드 HTTP 엔드포인트에 액세스할 수 있습니다. 통합 요청 또는 통합 응답은 설정하지 않습니다. API Gateway는 클라이언트로부터 수신되는 요청을 HTTP 엔드포인트로 전달하고 HTTP 엔드포인트에서 발신되는 응답을 클라이언트로 전달합니다.

• MOCK: 이 통합 유형을 사용하면 API Gateway에서 요청을 백엔드로 전송하지 않고 응답을 반환할 수 있습니다. 이것은 백엔드 사용에 대한 요금을 발생시키지 않으면서 통합 설정을 테스트하고 협력을 통한 API의 발전을 활성화하는 데 사용할 수 있으므로 API 테스트에 유용합니다.

  협력을 통한 발전을 통해 팀은 MOCK 통합을 사용해 다른 팀이 소유한 API 구성 요소의 시뮬레이션을 설정함으로써 자신의 개발 노력을 격리시킬 수 있습니다. 또한 API 메서드가 CORS 액세스를 허용하는지 확인하기 위해 CORS 관련 헤더를 반환하는 데도 유용합니다. 사실 API Gateway 콘솔은 OPTIONS 메서드를 통합하여 모의 통합으로 CORS를 지원합니다. 게이트웨이 응답은 모의 통합의 다른 예입니다.