Application Networking · API 관리

Amazon API Gateway

규모에 관계없이 API를 생성하고 안전하게 운영하세요

AWS Networking Services · First Call2026-10-17

Agenda

아젠다

  1. 서비스 개요
  2. 고객 과제
  3. 주요 이점
  4. 동작 방식
  5. 주요 기능
  6. 비교와 선택 기준
  7. 사용 사례
  8. 레퍼런스 아키텍처
  9. 비용
  10. 시작하기
  11. 다음 단계

Customer challenges

API 운영 시 흔히 겪는 문제

트래픽 급증에 대한 대응 부담

자체 API 인프라를 운영하면 트래픽 급증 시 백엔드 시스템이 과부하되지 않도록 제한, 캐싱, 오토스케일링을 직접 구성하고 관리해야 합니다. 인프라 관리에 시간을 소비하면 핵심 비즈니스 로직 개발에 집중하기 어렵습니다.

복잡한 인증 및 접근 제어 구현

다양한 클라이언트와 서드파티 개발자에게 API를 제공할 때, IAM 정책, OAuth 토큰, 사용자 지정 인증 로직을 직접 구현하고 유지 관리하는 것은 보안 위험과 개발 비용을 증가시킵니다.

API 수명 주기 관리의 어려움

여러 버전의 API를 동시에 운영하면서 개발, 테스트, 프로덕션 단계를 관리하고, 기존 사용자의 하위 호환성을 보장하는 것은 별도의 도구와 프로세스 없이는 복잡합니다.

Overview

Amazon API Gateway

Amazon API Gateway는 수십만 건의 동시 API 호출을 수용하고 처리하는 데 필요한 트래픽 관리, 인증, 제한, 모니터링, 버전 관리를 모두 처리합니다. 최소 요금이나 초기 비용 없이 사용한 만큼만 지불하며, 컨테이너, 서버리스, 웹 애플리케이션 워크로드를 지원합니다.

최대 71%
HTTP API의 REST API 대비 비용 절감
최대 60%
HTTP API의 REST API 대비 지연 시간 감소

Benefits

Amazon API Gateway를 선택하는 이유

Managed

완전관리형 API 인프라

API 호출 수용, 트래픽 관리, 인증, 제한, 모니터링, 버전 관리 등 API 운영에 필요한 모든 작업을 API Gateway가 처리합니다. 인프라 관리 대신 비즈니스 로직과 서비스 개발에 집중할 수 있습니다.

Security

유연한 보안 제어

IAM 정책, Amazon Cognito 사용자 풀, Lambda authorizer, OIDC 및 OAuth2를 지원합니다. 서명 버전 4 인증을 활용하여 API 요청을 검증하고, API 키와 사용량 계획으로 서드파티 개발자 접근을 관리할 수 있습니다.

Cost

사용량 기반 과금

최소 요금이나 초기 비용이 없습니다. 수신한 API 호출 수와 전송된 데이터 양에 대해서만 비용을 지불하며, 티어 기반 요금 모델을 통해 사용량이 증가할수록 단위 비용이 감소합니다.

How it works

Amazon API Gateway 핵심 개념

  1. 1

    HTTP API와 REST API

    API Gateway는 RESTful API를 만들기 위해 HTTP API와 REST API 두 가지 옵션을 제공합니다. HTTP API는 서버리스 워크로드와 HTTP 백엔드에 최적화되어 REST API 대비 최대 71% 비용 절감과 60% 지연 시간 감소를 제공합니다. REST API는 사용량 계획, API 키, 퍼블리싱 등 API 관리 기능이 필요한 경우에 적합합니다.

  2. 2

    WebSocket API

    WebSocket API는 클라이언트와 서버 간 상태 저장(stateful) 전이중(full-duplex) 통신을 지원합니다. 연결된 사용자 간 실시간 메시지 전송을 가능하게 하며, 메시지 내용에 따라 AWS Lambda, Amazon Kinesis 또는 HTTP 엔드포인트로 라우팅할 수 있습니다.

  3. 3

    스테이지와 API 수명 주기

    REST API에서 각 API는 여러 스테이지(예: dev, beta, production)를 가질 수 있으며, 동일 API의 여러 버전을 동시에 운영할 수 있습니다. 각 스테이지는 서로 다른 백엔드 엔드포인트와 연결되도록 구성할 수 있고, 스테이지 변수를 통해 설정 값을 관리합니다.

  4. 4

    API Gateway Portals

    API Gateway Portals는 완전관리형 개발자 포털을 제공합니다. AWS 인프라 전반의 REST API를 중앙에서 검색, 문서화, 거버넌스할 수 있으며, API를 구조화된 제품 형태로 분류하여 다양한 대상에게 제공할 수 있습니다.

Key features · 1/3

주요 기능

RESTful API 지원 (HTTP API / REST API)

HTTP API는 서버리스 워크로드와 HTTP 백엔드에 최적화되어 REST API 대비 최대 71% 비용 절감과 60% 지연 시간 감소를 제공합니다. REST API는 사용량 계획, API 키 등 API 관리 기능을 단일 솔루션으로 제공합니다.

WebSocket API

채팅 앱, 스트리밍 대시보드 등 실시간 양방향 통신 애플리케이션을 구축할 수 있습니다. API Gateway가 클라이언트와 백엔드 서비스 간 영구 연결을 유지하며 메시지 전송을 처리합니다.

API Gateway Portals

완전관리형 개발자 포털을 생성하여 AWS 인프라 전반의 REST API를 중앙에서 검색, 문서화, 거버넌스할 수 있습니다. API를 구조화된 제품 형태로 분류하여 다양한 대상에게 제공할 수 있습니다.

VPC 프라이빗 통합

HTTP API를 사용하여 VPC 내 프라이빗 ALB, 프라이빗 NLB, AWS Cloud Map에 등록된 IP 기반 서비스(예: ECS 태스크)로 요청을 라우팅할 수 있습니다.

Key features · 2/3

주요 기능

스로틀링 및 캐싱

HTTP 메서드별 초당 요청 수 기반 제한 규칙을 설정할 수 있습니다. REST API에서는 사용자 지정 키와 TTL을 사용한 API 데이터 캐싱을 구성하여 백엔드 호출을 줄일 수 있습니다.

인증 및 권한 부여

IAM 정책, Amazon Cognito 사용자 풀, Lambda authorizer, 서명 버전 4 인증을 지원합니다. HTTP API에서는 OIDC 및 OAuth2를 기본 지원하며, REST API에서는 API 키와 사용량 계획으로 서드파티 접근을 관리합니다.

API 운영 모니터링

Amazon CloudWatch와 통합되어 API 호출 수, 지연 시간, 오류율 등 백엔드 성능 지표를 대시보드에서 시각적으로 모니터링할 수 있습니다. CloudWatch Logs로 API 실행 오류를 기록하여 디버깅을 지원합니다.

SDK 생성

REST API에서 Java, JavaScript, Android용 Java, iOS용 Objective-C/Swift, Ruby 플랫폼의 클라이언트 SDK를 자동 생성할 수 있습니다. 생성된 SDK는 API 키 처리와 AWS 자격 증명을 사용한 요청 서명을 지원합니다.

Key features · 3/3

주요 기능

API 수명 주기 관리

REST API에서 동일 API의 여러 버전을 동시에 운영할 수 있습니다. 각 버전에 대해 alpha, beta, production 등 여러 릴리스 스테이지를 관리하며, 사용자 지정 도메인 이름과 연결할 수 있습니다.

AWS WAF 및 AWS X-Ray 통합

AWS WAF와 통합하여 일반적인 웹 공격으로부터 API를 보호하고, AWS X-Ray와 통합하여 성능 지연 시간을 분석하고 문제를 진단할 수 있습니다.

Compare

HTTP API와 REST API 비교

비교 항목HTTP APIREST API
최적 워크로드서버리스 워크로드, HTTP 백엔드 프록시API 프록시 기능과 API 관리 기능이 모두 필요한 경우
비용REST API 대비 최대 71% 절감표준 요금 적용
지연 시간REST API 대비 최대 60% 감소표준 지연 시간
OIDC / OAuth2 지원기본 지원Lambda authorizer를 통해 지원
API 키 / 사용량 계획미지원지원
SDK 생성미지원Java, JavaScript, Android, iOS, Ruby SDK 생성 지원
캐싱미지원사용자 지정 키와 TTL 기반 캐싱 지원
API 수명 주기 관리자동 배포 지원다중 버전, 다중 스테이지 관리 지원

Use cases

사용 사례

서버리스 웹 애플리케이션 백엔드

API Gateway와 AWS Lambda를 결합하여 서버리스 애플리케이션의 앱 대면(app-facing) 계층을 구성합니다. API Gateway가 API 프록시 역할을 하고 Lambda가 비즈니스 로직을 실행하므로, 서버를 관리하지 않고 확장 가능한 백엔드를 운영할 수 있습니다.

AWS 문서에서 보기 ↗

실시간 양방향 통신 애플리케이션

WebSocket API를 사용하여 채팅 앱, 스트리밍 대시보드, 알림 시스템 등 실시간 양방향 통신 애플리케이션을 구축할 수 있습니다. 서버를 직접 운영하거나 관리할 필요 없이 API Gateway가 영구 연결을 유지합니다.

AWS 제품 페이지에서 보기 ↗

서드파티 개발자 API 생태계 관리

REST API의 API 키, 사용량 계획, 제한 및 요청 할당량 제한을 활용하여 서드파티 개발자의 API 접근을 관리합니다. API 키별 사용량 데이터를 추출하여 API 사용 분석과 청구 문서 생성에 활용할 수 있습니다.

AWS 제품 페이지에서 보기 ↗

마이크로서비스 API 통합

Amazon EC2, Amazon ECS, AWS Elastic Beanstalk에서 실행되는 워크로드와 AWS Lambda 함수, AWS Step Functions 상태 머신 등 다양한 백엔드 서비스를 단일 API 엔드포인트로 통합합니다. VPC 내 프라이빗 리소스에 대한 라우팅도 지원합니다.

AWS 제품 페이지에서 보기 ↗

Reference architecture

서버리스 웹 애플리케이션 아키텍처

클라이언트(웹 브라우저, 모바일 앱)가 HTTPS를 통해 Amazon API Gateway에 API 요청을 보냅니다. API Gateway는 요청을 수신하고 인증/인가를 수행한 후, 백엔드 통합으로 구성된 AWS Lambda 함수를 호출합니다. Lambda 함수는 비즈니스 로직을 실행하고 필요에 따라 Amazon DynamoDB 등 AWS 서비스와 상호작용합니다. Lambda의 응답이 API Gateway를 통해 클라이언트에 반환됩니다. API Gateway는 Amazon CloudWatch와 통합되어 API 호출 수, 지연 시간, 오류율 등의 지표를 수집합니다.

Reference architecture

WebSocket 실시간 통신 아키텍처

클라이언트가 API Gateway의 WebSocket API에 연결하면, API Gateway가 영구 연결을 유지합니다. 클라이언트가 메시지를 전송하면 API Gateway는 메시지 내용에 따라 라우팅 규칙을 적용하여 AWS Lambda 함수, Amazon Kinesis, 또는 HTTP 엔드포인트를 호출합니다. 백엔드 서비스의 응답은 API Gateway를 통해 연결된 클라이언트에게 실시간으로 전달됩니다. 메시지는 최대 128KB까지 지원되며 32KB 단위로 과금됩니다.

Pricing · 1/2

비용 항목

Amazon API Gateway는 최소 요금이나 초기 비용 없이 사용한 만큼만 지불합니다. HTTP API와 REST API는 수신한 API 호출 수와 전송 데이터 양 기준으로 과금되며, WebSocket API는 송수신 메시지 수와 연결 시간 기준으로 과금됩니다. Private API는 데이터 전송 요금이 부과되지 않지만 AWS PrivateLink 요금이 적용됩니다.

HTTP API 호출
수신한 API 호출 수와 전송 데이터 양 기준으로 과금됩니다. 티어 기반 요금 모델이 적용되어 사용량이 증가할수록 단위 비용이 감소합니다.
REST API 호출
수신한 API 호출 수와 전송 데이터 양 기준으로 과금됩니다. Private API는 데이터 전송 요금이 없지만 AWS PrivateLink 요금이 적용됩니다. 선택적으로 데이터 캐싱을 활성화하면 캐시 크기에 따라 시간당 요금이 부과됩니다.
WebSocket API 메시지 및 연결
송수신 메시지 수와 총 연결 시간(connection minutes) 기준으로 과금됩니다. 메시지는 최대 128KB까지 지원되며 32KB 단위로 과금됩니다. ping/pong 등 제어 프레임 메시지는 과금되지 않습니다.
API Gateway Portals
Portal에 연결된 PortalProduct 수 기준으로 과금됩니다. 각 Portal의 월별 요금에는 10개의 PortalProduct(각 40개 ProductRestEndpoint 포함)가 포함되며, 추가 PortalProduct는 별도 과금됩니다. 월별 요금은 사용 기간에 비례하여 일할 계산됩니다.

단가는 리전마다 다릅니다. https://aws.amazon.com/api-gateway/pricing/

Pricing · 2/2

비용 항목

Free Tier
신규 AWS 고객에게 12개월간 매월 REST API 호출 100만 건, HTTP API 호출 100만 건, WebSocket 메시지 100만 건 및 연결 75만 분이 무료로 제공됩니다.

단가는 리전마다 다릅니다. https://aws.amazon.com/api-gateway/pricing/

Getting started

시작하기

  1. 1

    1단계: API 유형 선택

    워크로드 요구사항에 따라 HTTP API, REST API, WebSocket API 중 적합한 유형을 선택합니다. 서버리스 워크로드와 HTTP 백엔드 프록시에는 HTTP API가 적합하고, API 관리 기능(사용량 계획, API 키)이 필요하면 REST API를, 실시간 양방향 통신이 필요하면 WebSocket API를 선택합니다.

  2. 2

    2단계: 리소스 및 메서드 정의

    API의 리소스(엔드포인트 경로)와 각 리소스에서 지원할 HTTP 메서드(GET, POST, PUT, DELETE 등)를 정의합니다. OpenAPI 정의를 가져와서 API를 생성할 수도 있습니다.

  3. 3

    3단계: 백엔드 통합 구성

    각 메서드에 대해 백엔드 통합을 구성합니다. AWS Lambda 함수, HTTP 엔드포인트, AWS Step Functions, Amazon EC2, Amazon ECS 등 다양한 백엔드 서비스와 연결할 수 있습니다. VPC 내 프라이빗 리소스에 대한 통합도 설정할 수 있습니다.

  4. 4

    4단계: 인증 및 보안 설정

    IAM 정책, Amazon Cognito, Lambda authorizer, OIDC/OAuth2 중 적합한 인증 방식을 구성합니다. 필요에 따라 AWS WAF를 통합하여 웹 공격으로부터 API를 보호하고, API 키와 사용량 계획으로 서드파티 접근을 제어합니다.

  5. 5

    5단계: 스테이지 배포 및 모니터링

    API를 개발(dev), 스테이징(staging), 프로덕션(production) 등 스테이지에 배포합니다. Amazon CloudWatch 대시보드에서 API 호출 수, 지연 시간, 오류율을 모니터링하고, 필요에 따라 사용자 지정 알람을 설정합니다.

Next steps

다음 단계

API Gateway 개발자 가이드

API Gateway의 아키텍처, 기능, API 유형별 시작 방법을 상세히 설명하는 공식 개발자 문서입니다.

API Gateway 요금 페이지

HTTP API, REST API, WebSocket API, API Gateway Portals의 과금 기준과 요금 예시를 확인할 수 있습니다.

API Gateway FAQ

API 유형 선택, 보안, 제한, 캐싱, 과금 등 자주 묻는 질문에 대한 답변을 확인할 수 있습니다.

AWS 요금 계산기

API Gateway를 포함한 AWS 서비스의 월별 비용을 예측할 수 있는 계산기입니다.

Resources

참고 자료

Q&A