Amazon API Gateway 할당량 및 중요 정보 - Amazon API Gateway

Amazon API Gateway 할당량 및 중요 정보

특별한 언급이 없는 한 요청 시 할당량을 높일 수 있습니다. 할당량 증가를 요청하려면 서비스 할당량을 사용하거나 AWS 지원 센터에 문의할 수 있습니다.

권한 부여가 활성화된 메서드의 경우, 메서드 ARN(예: arn:aws:execute-api:{region-id}:{account-id}:{api-id}/{stage-id}/{method}/{resource}/{path})의 최대 길이는 1,600바이트입니다. 경로 파라미터 값(실행 시간에 크기가 결정됨) 으로 인해 ARN 길이는 한도를 초과할 수 있습니다. 이 경우 API 클라이언트는 414 Request URI too long 응답을 수신합니다.

참고

이는 리소스 정책이 사용될 때 URI 길이를 제한합니다. 리소스 정책이 필요한 프라이빗 API의 경우 모든 프라이빗 API의 URI 길이가 제한됩니다.

리전당 API Gateway 계정 수준 할당량

다음 할당량은 Amazon API Gateway에서 리전별로 계정당 적용됩니다.

리소스 또는 작업 기본 할당량 높일 수 있음
HTTP API, REST API, WebSocket API 및 WebSocket 콜백 API에서의 리전별 계정당 조절 할당량 5,000개의 요청을 처리할 수 있는 최대 버킷 용량을 사용하여 토큰 버킷 알고리즘에서 제공하는 추가 버스트 용량이 있는 초당 10,000개의 요청(RPS). *
참고

버스트 할당량은 리전의 해당 계정에 대한 전체 RPS 할당량에 따라 API Gateway 서비스 팀에서 결정됩니다. 이 할당량은 고객이 조절하거나 변경을 요청할 수 없습니다.

리전 API 600 아니요
엣지 최적화 API 120 아니요

* 아프리카(케이프타운) 및 유럽(밀라노) 리전의 경우 기본 조절 할당량은 2500 RPS이고, 기본 버스트 할당량은 1250 RPS입니다.

HTTP API 할당량

API Gateway에서의 HTTP API 구성 및 실행에는 다음 할당량이 적용됩니다.

리소스 또는 작업 기본 할당량 높일 수 있음
API당 라우팅 300
API당 통합 수 300 아니요
최대 통합 제한 시간 30초 아니요
API당 단계 10
단계당 태그 수 50 아니요
요청 라인 및 헤더 값의 총 결합 크기 10,240바이트 아니요
페이로드 크기 10MB 아니요
리전별 계정당 사용자 지정 도메인 120
액세스 로그 템플릿 크기 3KB 아니요
Amazon CloudWatch Logs 로그 항목 1MB 아니요
API별 권한 부여자 10
권한 부여자별 대상 그룹 50 아니요
경로별 범위 10 아니요
JSON Web Key Set 엔드포인트에 대한 제한 시간 1500ms 아니요
JSON Web Key Set 엔드포인트의 응답 크기 150,000바이트 아니요
OpenID Connect 검색 엔드포인트에 대한 제한 시간 1500ms 아니요
리전별 계정당 VPC 링크 10
VPC 링크당 서브넷 10
단계별 단계 변수 100 아니요

WebSocket API 구성 및 실행에 대한 API Gateway 할당량

Amazon API Gateway에서의 WebSocket API 구성 및 실행에는 다음 할당량이 적용됩니다.

리소스 또는 작업 기본 할당량 높일 수 있음
리전별 계정당 초당 새 연결 수(모든 WebSocket API에서) 500
동시 연결 해당 사항 없음 * 해당 사항 없음
API당 AWS Lambda 권한 부여자 10
AWS Lambda 권한 부여자 결과 크기 8KB 아니요
API당 라우팅 300
API당 통합 수 300
API당 단계 10
WebSocket 프레임 크기 32KB 아니요
페이로드 크기 관리 128KB ** 아니요
WebSocket API 연결 기간 2시간 아니요
유휴 연결 제한 시간 10분 아니요

* API Gateway는 동시 연결에 할당량을 적용하지 않습니다. 최대 동시 연결 수는 초당 새 연결 속도와 최대 연결 지속 시간(2시간)에 의해 결정됩니다. 예를 들어 기본 할당량이 초당 500개의 새 연결인 경우 클라이언트가 2시간에 걸쳐 최대 속도로 연결하는 경우 API Gateway는 최대 3,600,000개의 동시 연결을 제공할 수 있습니다.

** WebSocket 프레임 크기 할당량이 32KB이기 때문에 32KB를 초과하는 메시지는 32KB 이하의 여러 프레임으로 분할되어야 합니다. 큰 메시지(또는 큰 프레임 크기)가 수신되면 코드 1009와 함께 연결이 해제됩니다.

REST API 구성 및 실행에 대한 API Gateway 할당량

Amazon API Gateway에서의 REST API 구성 및 실행에는 다음 할당량이 적용됩니다.

리소스 또는 작업 기본 할당량 높일 수 있음
리전별 계정당 사용자 지정 도메인 이름 120
엣지 최적화된 API에 대한 URL의 길이(문자 수) 8192 아니요
지역 API에 대한 URL의 길이(문자 수) 10240 아니요
리전별 계정당 프라이빗 API 600 아니요
API Gateway 리소스 정책의 길이(문자 수 단위) 8192
리전별 계정당 API 키 500
리전별 계정당 클라이언트 인증서 60
API별 권한 부여자(AWS Lambda 및 Amazon Cognito) 10
API당 설명서 부분 2000
API당 리소스 300
API당 단계 10
단계별 단계 변수 100 아니요
단계 변수의 키의 길이(문자 수) 64 아니요
단계 변수의 값의 길이(문자 수) 512 아니요
리전별 계정당 사용량 계획 300
API 키당 사용량 계획 10
리전별 계정당 VPC 링크 20
API 캐싱 TTL 기본적으로 300초이고 API 소유자가 0~3600으로 구성 가능합니다. 상한용이 아님(3600)
캐싱된 응답 크기 1048576바이트 캐시 데이터 암호화는 캐싱되는 항목의 크기를 증가시킬 수 있습니다. 아니요
통합 시간제한 Lambda, Lambda 프록시, HTTP, HTTP 프록시 및 AWS 통합을 포함하는 모든 통합 유형의 경우, 50밀리초 - 29초. 하한 또는 상한에는 해당되지 않음.
모든 헤더 값의 전체 결합 크기 10240바이트 아니요
페이로드 크기 10MB 아니요
단계당 태그 수 50 아니요
매핑 템플릿의 #foreach ... #end 루프의 반복 횟수 1000 아니요
권한 부여가 포함된 메서드의 ARN 길이 1600 bytes 아니요

restapi:import 또는 restapi:put의 경우, API 정의 파일의 최대 크기는 6MB입니다.

모든 API별 할당량은 특정 API에서만 증가시킬 수 있습니다.

API 생성, 배포 및 관리를 위한 API Gateway 할당량

API Gateway에서 AWS CLI, API Gateway 콘솔 또는 API Gateway REST API 및 SDK를 사용하여 API를 생성, 배포 및 관리하는 경우 다음과 같이 고정된 할당량이 적용됩니다. 이러한 할당량은 늘릴 수 없습니다.

작업 기본 할당량 높일 수 있음
CreateApiKey 계정 한 개에 대해 초당 5개의 요청 아니요
CreateDeployment 계정 한 개에 대해 5초당 1개의 요청 아니요
CreateDocumentationVersion 계정 한 개에 대해 20초당 1개의 요청 아니요
CreateDomainName 계정 한 개에 대해 30초당 1개의 요청 아니요
CreateResource 계정 한 개에 대해 초당 5개의 요청 아니요
CreateRestApi

리전 또는 프라이빗 API

  • 계정 한 개에 대해 3초당 1개의 요청

엣지 최적화 API

  • 계정 한 개에 대해 30초당 1개의 요청

아니요
CreateVpcLink(V2) 계정 한 개에 대해 15초당 1개의 요청 아니요
DeleteApiKey 계정 한 개에 대해 초당 5개의 요청 아니요
DeleteDomainName 계정 한 개에 대해 30초당 1개의 요청 아니요
DeleteResource 계정 한 개에 대해 초당 5개의 요청 아니요
DeleteRestApi 계정 한 개에 대해 30초당 1개의 요청 아니요
GetResources 계정 한 개에 대해 2초당 5개의 요청 아니요
DeleteVpcLink(V2) 계정 한 개에 대해 30초당 1개의 요청 아니요
ImportDocumentationParts 계정 한 개에 대해 30초당 1개의 요청 아니요
ImportRestApi

리전 또는 프라이빗 API

  • 계정 한 개에 대해 3초당 1개의 요청

엣지 최적화 API

  • 계정 한 개에 대해 30초당 1개의 요청

아니요
PutRestApi 계정 한 개에 대해 초당 1개의 요청 아니요
UpdateAccount 계정 한 개에 대해 20초당 1개의 요청 아니요
UpdateDomainName 계정 한 개에 대해 30초당 1개의 요청 아니요
UpdateUsagePlan 계정 한 개에 대해 20초당 1개의 요청 아니요
기타 작업 총 계정 할당량까지 할당량이 없습니다. 아니요
총 작업 초당 40개의 요청이 버스트 할당량인 초당 10개의 요청입니다. 아니요