기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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 | 아니요 |
* 아프리카(케이프타운) 및 유럽(밀라노) 리전의 경우 기본 조절 할당량은 2500 RPS이고, 기본 버스트 할당량은 1250 RPS입니다.
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 ** | 아니요 |
| 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 구성 및 실행에는 다음 할당량이 적용됩니다.
| 리소스 또는 작업 | 기본 할당량 | 높일 수 있음 |
|---|---|---|
| 리전별 계정당 사용자 지정 도메인 이름 | 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 | 아니요 |
| 권한 부여가 포함된 메서드의 ARN 길이 | 1600 bytes | 아니요 |
| 사용량 계획의 단계에 대한 메서드 수준 제한 설정 | 20 | 예 |
| API당 모델 크기 | 400KB | 아니요 |
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
엣지 최적화 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개의 요청입니다. | 아니요 |
