투케이2K

105. (Aws/Amazon) [Amazon API Gateway] Aws 게이트웨이 REST 방식 API 호출 시 Lambda 프록시 통합 설정 방법 - Query Params 본문

Aws (Amazon)

105. (Aws/Amazon) [Amazon API Gateway] Aws 게이트웨이 REST 방식 API 호출 시 Lambda 프록시 통합 설정 방법 - Query Params

투케이2K 2025. 8. 23. 10:20
728x90

[개발 환경 설정]

개발 환경 : Aws / Amazon Web Services

 

[설명 정리]

// --------------------------------------------------------------------------------------
[개발 및 환경]
// --------------------------------------------------------------------------------------

- 인프라 : Aws / Amazon Web Services


- 기술 구분 : Aws / Aws API Gateway / Lambda / API


- 사전) Aws API Gateway 게이트웨이 설명 정리 - 중개 서버 : 

  >> Aws API Gateway 는 규모와 관계없이 REST 및 WebSocket API 를 생성, 게시, 유지, 모니터링 및 보호하기 위한 AWS 서비스입니다

  >> Aws API Gateway 는 트래픽 관리, CORS 지원, 권한 부여 및 액세스 제어, 제한, 모니터링 및 API 버전 관리 등 최대 수십만 개의 동시 API 호출을 수신 및 처리하는 데 관계된 모든 작업을 처리합니다

  >> Aws API Gateway 에서 제공하는 대표적 API 종류 : 

    - [RESTful] HTTP API : 프록시 기능 정도만을 사용할 때 적합하며, 단순하고 빠릅니다

    - [RESTful] REST API : API 관리 기능 및 API 요청/응답에 대한 제어가 필요할 경우 사용합니다

    - WebSocket API : 웹소켓 (실시간 양방향 통신) 사용 시 주로 사용합니다 
  
      : API Gateway는 백엔드 서비스와 클라이언트 간의 메시지 전송을 처리하기 위해 지속적인 연결을 유지합니다

    -  참고 : API Gateway 는 표준 HTTP 메서드 (예: GET, POST, PUT, PATCH, DELETE) 를 구현합니다


- 사전) Aws Lambda 함수 설명 : 

  >> Aws Lambda 는 서버 리스 FaaS 솔루션으로, 함수의 인스턴스를 실행하여 이벤트를 처리할 수 있습니다

  >> Aws Lambda 는 이벤트에 응답하여 코드를 실행 하고 해당 코드에 필요한 컴퓨팅 리소스를 자동으로 관리합니다

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[설 명]
// --------------------------------------------------------------------------------------

1. Aws 사이트 접속 후 로그인 수행 실시


2. Aws 사이트에서 상단 [ 검색 ] 메뉴 옆에 >> 메뉴 펼치기 클릭 수행 [ ▦ ]


3. [모든 서비스] 메뉴 클릭 후 >> API Gateway 검색 수행


4. [API Gateway] 화면에서 좌측 > [API] 메뉴 클릭 수행


5. 표시 된 API 리스트에서 특정 API 클릭 수행

  >> Lambda 프록시 통합 설정이 되어 있지 않은 API 클릭 필요


6. [리소스] 메뉴에서 특정 Path 경로 및 메소드 클릭 수행

  >> ex (path) : /view

  >> ex (method) : GET


7. 특정 메소드 정보 표시 화면에서 [통합 요청] 메뉴 클릭 수행


8. [통합 요청] 메뉴에서 [편집] 메뉴 클릭 수행


9. [비활성화] 되어 있는 [Lambda 프록시 통합] 기능을 [활성] 으로 변경 수행

  >> 통합 요청 설정이 Lambda Proxy 통합으로 되어 있어야 query parameter가 자동으로 전달됩니다

  >> REST API 의 경우 통합 요청에서 매핑 템플릿을 사용하면 query parameter가 누락될 수 있습니다


10. 저장 및 API 재배포 수행 실시


11. REST API 호출 툴에서 Query Params 를 지정해서 API 호출 테스트 수행


12. API Gateway 에 매핑 되어 있는 Lambda 함수 Input 값에 파라미터가 정상적으로 들어 온 것 확인

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

[Amazon API Gateway] Aws API Gateway 게이트웨이 설명 정리 - 중개 서버

https://blog.naver.com/kkh0977/223827753479?trackingCode=blog_bloghome_searchlist


[Aws API Gateway REST API]

https://docs.aws.amazon.com/ko_kr/apigateway/latest/developerguide/apigateway-rest-api.html


[Aws API Gateway의 REST API에 대한 API 엔드포인트 유형]

https://docs.aws.amazon.com/ko_kr/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html


[Aws API Gateway에서 퍼블릭 또는 프라이빗 API 엔드포인트 유형 변경]

https://docs.aws.amazon.com/ko_kr/apigateway/latest/developerguide/apigateway-api-migration.html


[Aws Lambda] Aws 사이트에서 생성 된 Lambda 람다 검증 함수 리스트 및 내용 소스 코드 확인 방법

https://blog.naver.com/kkh0977/223765198383


[Aws API Gateway 게이트웨이 생성 및 Lambda 람다 함수 연동 방법]

https://blog.naver.com/kkh0977/223919568635

// --------------------------------------------------------------------------------------
728x90
반응형
Comments