AWS API Gateway의 API 유형 개요

동기

AWS API Gateway를 터치할 기회가 있었으므로 메모합니다. REST API와 HTTP API의 기능 비교를 간단히 정리한다.

REST API 및 HTTP API 개요

FAQ에서 발췌 한 내용은 아래에 설명되어 있습니다.

HTTP API는 다음과 같은 경우에 적합합니다.
1. AWS Lambda 또는 HTTP 엔드포인트용 프록시 API 빌드
2. OIDC 및 OAuth2 인증을 갖춘 최신 API 구축
3. 매우 큰 규모가 될 수 있는 워크로드
4. 대기 시간에 민감한 워크로드용 API

REST API는 다음과 같은 경우에 적합합니다.
1. API를 구축, 관리 및 게시하는 데 필요한 모든 기능을 포함하는 세트에 대해 단일 가격을 지불하려는 고객.

HTTP API 는 REST API 와 비교해 기능을 좁히고 있는 만큼, 저 레이턴시 저비용을 우리로 하고 있는 것 같다. 대기 시간 차이에 대해 설명하는 문서는 찾을 수 없었지만 가격은 Amazon API Gateway 요금에 설명되어 있으며 단순 계산으로 HTTP API의 경우 REST API의 약 1/3 비용이 될 것 같습니다.

REST API와 HTTP API 비교

기본적인 기능 비교는 Choosing Between HTTP APIs and REST APIs에 써 있다. 그 외, 신경이 쓰인 점에 대해서 기재한다.

응답 템플릿

REST API
응답 템플릿 (게이트웨이 응답)이 제공되며 응답 구조를 사용자 정의 할 수 있습니다.

HTTP API
템플릿이 제공되지 않으므로 변경할 수 없습니다. 예를 들어 인증에 실패했을 경우에 돌려주는 JSON 오브젝트의 키는 디폴트의 값으로부터 변경할 수 없고, 이하와 같이 된다.

{ "message": "Missing Authentication Token" }

백엔드로 설정할 수 있는 HTTP 엔드포인트

REST API는 VPC Link를 통해 VPC 내에 있는 개인 HTTP 엔드포인트에 대한 요청을 허용합니다. Set up API Gateway Private Integrations
HTTP API에서도 며칠 전에 베타 버전이 취해 REST API와 같은 기능을 이용할 수 있게 된 것 같다. 시도하지 않았습니다. Working with VPC Links for HTTP APIs

기타

문서 내용에 차이가 있어 다소 혼란스러웠다. 일본판 문서는 갱신이 느린 것 같기 때문에 참고 정도에 두어야 한다.

Amazon API Gateway란?

What Is Amazon API Gateway?

소감

REST API와 HTTP API의 기능 차이는 더 세밀해야 할 것이므로 수시로 업데이트하고 싶습니다.