Amazon API Gateway 할당량 및 중요 정보
다음 섹션에서는 Amazon API Gateway의 할당량에 대해 설명합니다. 특별한 언급이 없는 한 요청 시 할당량을 높일 수 있습니다. 할당량 증가를 요청하려면 Service Quotas를 사용하거나 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개의 요청을 처리할 수 있는 최대 버킷 용량을 사용하여 토큰 버킷 알고리즘참고버스트 할당량은 리전의 해당 계정에 대한 전체 RPS 할당량에 따라 API Gateway 서비스 팀에서 결정됩니다. 이 할당량은 고객이 조절하거나 변경을 요청할 수 없습니다. |
예 |
| 리전 API | 600 | 아니요 |
| 엣지 최적화 API | 120 | 아니요 |
* 다음 리전의 기본 스로틀링 할당량은 2,500RPS이고 기본 버스트 할당량은 1,250RPS입니다. 아프리카(케이프타운), 유럽(밀라노), 아시아 태평양(자카르타), 중동(UAE), 아시아 태평양(하이데라바드), 아시아 태평양(멜버른), 유럽(스페인), 유럽(취리히), 이스라엘(텔아비브), 캐나다 서부(캘거리), 아시아 태평양(말레이시아).
HTTP API 할당량
API Gateway에서의 HTTP API 구성 및 실행에는 다음 할당량이 적용됩니다.
| 리소스 또는 작업 | 기본 할당량 | 높일 수 있음 |
|---|---|---|
| API당 라우팅 | 300 | 예 |
| API당 통합 수 | 300 | 아니요 |
| 최대 통합 제한 시간 | 30초 | 아니요 |
| API당 단계 | 10 | 예 |
| 도메인별 멀티 레벨 API 매핑 | 200 | 아니요 |
| 단계당 태그 수 | 50 | 아니요 |
| 요청 라인 및 헤더 값의 총 결합 크기 | 10,240바이트 | 아니요 |
| 페이로드 크기 | 10MB | 아니요 |
| 리전별 계정당 사용자 지정 도메인 | 120 | 예 |
| 액세스 로그 템플릿 크기 | 3KB | 아니요 |
| Amazon CloudWatch Logs 로그 항목 | 1MB | 아니요 |
| API별 권한 부여자 | 10 | 예 |
| 권한 부여자별 대상 그룹 | 50 | 아니요 |
| 경로별 범위 | 10 | 아니요 |
| JSON Web Key Set 엔드포인트에 대한 제한 시간 | 1500ms | 아니요 |
| JSON Web Key Set 엔드포인트의 응답 크기 | 150000바이트 | 아니요 |
| OpenID Connect 검색 엔드포인트에 대한 제한 시간 | 1500ms | 아니요 |
| Lambda 권한 부여자 응답 시간 제한 | 10,000ms | 아니요 |
| 리전별 계정당 VPC 링크 | 10 | 예 |
| VPC 링크당 서브넷 | 10 | 예 |
| 단계별 단계 변수 | 100 | 아니요 |
| 단계 변수의 키의 길이(문자 수) | 64 | 아니요 |
| 단계 변수의 값의 길이(문자 수) | 512 | 아니요 |
WebSocket API 구성 및 실행에 대한 API Gateway 할당량
Amazon API Gateway에서의 WebSocket API 구성 및 실행에는 다음 할당량이 적용됩니다.
| 리소스 또는 작업 | 기본 할당량 | 높일 수 있음 |
|---|---|---|
| 리전별 계정당 초당 새 연결 수(모든 WebSocket API에서) | 500 | 예 |
| 동시 연결 | 해당 사항 없음 * | 해당 사항 없음 |
| AWS LambdaAPI별 권한 부여자 | 10 | 예 |
| AWS Lambda 권한 부여자 결과 크기 | 8KB | 아니요 |
| API당 라우팅 | 300 | 예 |
| API당 통합 수 | 300 | 예 |
| 통합 시간제한 | Lambda, Lambda 프록시, HTTP, HTTP 프록시 및 AWS 통합을 포함하는 모든 통합 유형의 경우, 50밀리초 - 29초. | 아니요 |
| API당 단계 | 10 | 예 |
| WebSocket 프레임 크기 | 32KB | 아니요 |
| 페이로드 크기 관리 | 128KB ** | 아니요 |
| 최대 매핑 템플릿 크기 | 300KB | 아니요 |
| WebSocket API 연결 기간 | 2시간 | 아니요 |
| 유휴 연결 제한 시간 | 10분 | 아니요 |
| WebSocket API에 대한 URL의 길이(문자 수) | 4096 | 아니요 |
* API Gateway는 동시 연결에 할당량을 적용하지 않습니다. 최대 동시 연결 수는 초당 새 연결 속도와 최대 연결 지속 시간(2시간)에 의해 결정됩니다. 예를 들어 기본 할당량이 초당 500개의 새 연결인 경우 클라이언트가 2시간에 걸쳐 최대 속도로 연결하는 경우 API Gateway는 최대 3,600,000개의 동시 연결을 제공할 수 있습니다.
** WebSocket 프레임 크기 할당량이 32KB이기 때문에 32KB를 초과하는 메시지는 32KB 이하의 여러 프레임으로 분할되어야 합니다. 이는 @connections 명령에 적용됩니다. 큰 메시지(또는 큰 프레임 크기)가 수신되면 코드 1009와 함께 연결이 해제됩니다.
REST API 구성 및 실행에 대한 API Gateway 할당량
Amazon API Gateway에서의 REST API 구성 및 실행에는 다음 할당량이 적용됩니다. restapi:import 또는 restapi:put의 경우, API 정의 파일의 최대 크기는 6MB입니다.
모든 API별 할당량은 특정 API에서만 증가시킬 수 있습니다.
| 리소스 또는 작업 | 기본 할당량 | 높일 수 있음 |
|---|---|---|
| 리전별 계정당 사용자 지정 도메인 이름 | 120 | 예 |
| 도메인별 멀티 레벨 API 매핑 | 200 | 아니요 |
| 엣지 최적화된 API에 대한 URL의 길이(문자 수) | 8192 | 아니요 |
| 지역 API에 대한 URL의 길이(문자 수) | 10240 | 아니요 |
| 리전별 계정당 프라이빗 API | 600 | 아니요 |
| API Gateway 리소스 정책의 길이(문자 수 단위) | 8192 | 예 |
| 리전별 계정당 API 키 | 10000 | 아니요 |
| 리전별 계정당 클라이언트 인증서 | 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바이트 | 아니요 |
| 프라이빗 API의 경우 모든 헤더 값의 전체 결합 크기 | 8000바이트 | 아니요 |
| 페이로드 크기 | 10MB | 아니요 |
| 단계당 태그 수 | 50 | 아니요 |
매핑 템플릿의 #foreach ... #end 루프의 반복 횟수 |
1000 | 아니요 |
| 최대 매핑 템플릿 크기 | 300KB | 아니요 |
| 권한 부여가 포함된 메서드의 ARN 길이 | 1600 bytes | 아니요 |
| 사용량 계획의 단계에 대한 메서드 수준 제한 설정 | 20 | 예 |
| API당 모델 크기 | 400KB | 아니요 |
| 트러스트 스토어에 있는 인증서 수 | 인증서 1,000개(총 개체 크기 최대 1MB) | 아니요 |
* 통합 제한 시간은 50밀리초 미만으로 설정할 수 없습니다. 리전 API 및 프라이빗 API의 경우 통합 제한 시간을 29초 넘게 늘릴 수 있지만, 이렇게 하려면 계정의 리전 수준 제한 할당량 한도를 줄여야 할 수 있습니다.
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
엣지 최적화 API
|
아니요 |
| 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
엣지 최적화 API
|
아니요 |
| PutRestApi | 계정 한 개에 대해 초당 1개의 요청 | 아니요 |
| UpdateAccount | 계정 한 개에 대해 20초당 1개의 요청 | 아니요 |
| UpdateDomainName | 계정 한 개에 대해 30초당 1개의 요청 | 아니요 |
| UpdateUsagePlan | 계정 한 개에 대해 20초당 1개의 요청 | 아니요 |
| 기타 작업 | 총 계정 할당량까지 할당량이 없습니다. | 아니요 |
| 총 작업 | 초당 40개의 요청이 버스트 할당량인 초당 10개의 요청입니다. | 아니요 |
