# REST API 구성 및 실행에 대한 API Gateway 할당량
<a name="api-gateway-execution-service-limits-table"></a>

Amazon API Gateway에서의 REST API 구성 및 실행에는 다음 할당량이 적용됩니다. 할당량이 API별로 적용되는 경우, 계정의 모든 API가 아닌 특정 API에 대해서만 할당량을 늘릴 수 있습니다.

계정 수준 할당량에 대한 자세한 내용은 [Amazon API Gateway 할당량](limits.md) 섹션을 참조하세요.


| 리소스 또는 작업 | 기본 할당량 | 높일 수 있음 | 
| --- | --- | --- | 
| 리전별 계정당 퍼블릭 사용자 지정 도메인 이름 | 120 | [예](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A93447B8) | 
| 리전별 계정당 프라이빗 사용자 지정 도메인 이름 | 50 | [예](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-24E7E662) | 
| 리전별 리전 API | 600 | 아니요 | 
| 리전별 엣지 최적화 API | 120 | 아니요 | 
| 리전별 계정당 프라이빗 API | 600 | 아니요 | 
| 계정당 도메인 이름 액세스 연결 | 100 | [예](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-4D98A8A5) | 
| 도메인별 멀티 레벨 API 매핑 | 200 | 아니요 | 
| 도메인당 라우팅 규칙 | 50 | [예](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-68B79FF0) | 
| 엣지 최적화된 API에 대한 URL의 길이(문자 수) | 8192 | 아니요 | 
| 리전 API에 대한 URL의 길이(문자 수) | 10240 | 아니요 | 
| 프라이빗 API에 대한 URL의 길이(문자 수) | 8192 | 아니요 | 
| API Gateway 리소스 정책의 길이(문자 수 단위) | 8192 | [예](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-8B81B02C) | 
| 리전별 계정당 API 키 | 10000 | 아니요 | 
| 리전별 계정당 클라이언트 인증서 | 60 | [예](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-824C9E42) | 
| API별 권한 부여자(AWS Lambda 및 Amazon Cognito) | 10 | 예<br /> 이 할당량을 늘리려면 [AWS Support Center](https://console.aws.amazon.com/support/home#/)에 문의하세요. | 
| API당 설명서 부분 | 2000 | 예<br /> 이 할당량을 늘리려면 [AWS Support Center](https://console.aws.amazon.com/support/home#/)에 문의하세요. | 
| API당 리소스 | 300 | [예](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) | 
| API당 단계 | 10 | [예](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) | 
| 단계별 단계 변수 | 100 | 아니요 | 
| 단계 변수의 키의 길이(문자 수) | 64 | 아니요 | 
| 단계 변수의 값의 길이(문자 수) | 512 | 아니요 | 
| 리전별 계정당 사용량 계획 | 300 | [예](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E8693075) | 
| API 키당 사용량 계획 | 10 | [예](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-985EB478) | 
| 리전별 계정당 VPC 링크 | 20 | [예](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A4C7274F) | 
| API 캐싱 TTL | 기본적으로 300초이고 API 소유자가 0\~3600으로 구성 가능합니다. | 상한용이 아님(3600) | 
| 캐싱된 응답 크기 | 1048576바이트 캐시 데이터 암호화는 캐싱되는 항목의 크기를 증가시킬 수 있습니다. | 아니요 | 
| 리전 API의 통합 제한 시간 | Lambda, Lambda 프록시, HTTP, HTTP 프록시 및 AWS 통합을 포함하는 모든 통합 유형의 경우, 50밀리초 - 29초. | [예 \*](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) | 
| 엣지 최적화 API의 통합 제한 시간 | Lambda, Lambda 프록시, HTTP, HTTP 프록시 및 AWS 통합을 포함하는 모든 통합 유형의 경우, 50밀리초 - 29초. | 아니요 | 
| 프라이빗 API의 통합 제한 시간 | Lambda, Lambda 프록시, HTTP, HTTP 프록시 및 AWS 통합을 포함하는 모든 통합 유형의 경우, 50밀리초 - 29초. | [예 \*](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) | 
| 헤더 이름, 값, 행 종결자(있는 경우) 및 공백을 포함한 모든 헤더 값의 총크기 | 10240바이트 | 아니요 | 
| 프라이빗 API의 경우 모든 헤더 값의 전체 결합 크기 | 8000바이트 | 아니요 | 
| 페이로드 크기 | 10MB | 아니요 | 
| 단계당 태그 수 | 50 | 아니요 | 
| 매핑 템플릿의 \#foreach ... \#end 루프의 반복 횟수 | 1000 | 아니요 | 
| 최대 매핑 템플릿 크기 | 300KB | 아니요 | 
| 액세스 로그 템플릿 크기 | 3KB | 아니요 | 
| 메서드 ARN 길이 | 1600바이트. 메서드에 경로 파라미터가 포함되어 있고 클라이언트가 ARN 길이를 초과하는 값을 사용하는 경우 API는 414 Request URI too long 응답을 반환합니다. | 아니요 | 
| 사용량 계획의 단계에 대한 메서드 수준 제한 설정 | 20 | 예<br /> 이 할당량을 늘리려면 [AWS Support Center](https://console.aws.amazon.com/support/home#/)에 문의하세요. | 
| API당 모델 크기 | 400KB | 아니요 | 
| 트러스트 스토어에 있는 인증서 수 | 인증서 1,000개(총 개체 크기 최대 1MB) | 아니요 | 
| 유휴 연결 제한 시간 | 310초 | 아니요 | 
| [restapi:import](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) 또는 [restapi:put](https://docs.aws.amazon.com/apigateway/latest/api/API_PutRestApi.html) 사용 시 최대 API 정의 파일 크기 | 6MB | 아니요 | 

\* 통합 제한 시간은 50밀리초 미만으로 설정할 수 없습니다. 통합 제한 시간을 29초가 넘도록 늘릴 수 있지만, 이렇게 하려면 계정의 리전 수준 스로틀링 할당량을 줄여야 할 수 있습니다.

## 할당량 감소를 위한 모범 사례
<a name="api-gateway-execution-service-limits-best-practices"></a>

다음 모범 사례는 현재 리소스를 줄여 할당량 증가를 방지하는 데 도움이 될 수 있습니다. 이러한 제안 사항이 해당 API 아키텍처에 적합한지 확인하세요.

**리전당 API**  
리전당 API 수를 줄이기 위해 사용하지 않는 API를 모두 내보낸 다음 API Gateway에서 삭제합니다. 자세한 내용은 [API Gateway에서 REST API 내보내기](api-gateway-export-api.md) 섹션을 참조하세요.

**API당 단계**  
API당 스테이지 수를 줄이기 위해 API를 여러 개의 API로 분할합니다.

**API당 리소스**  
`{proxy+}` 경로를 사용하여 리소스 수를 줄입니다. 자세한 내용은 [프록시 리소스를 사용하여 프록시 통합 설정](api-gateway-set-up-simple-proxy.md) 섹션을 참조하세요.

**API 매핑**  
사용자 지정 도메인 이름에 대한 API 매핑 수를 줄이기 위해 `/prod`와 같은 단일 수준의 API 매핑을 사용합니다. 단일 수준의 API 매핑은 API 매핑 할당량에 포함되지 않습니다.

**API별 권한 부여자**  
API당 권한 부여자 수를 줄이기 위해 API 메서드에서 권한 부여자를 재사용합니다.

**API당 설명서 부분**  
API당 설명서 부분 수를 줄이기 위해 API를 가져올 때 `ignore=documentation`을 사용합니다. 자세한 내용은 [API 설명서 가져오기](api-gateway-documenting-api-quick-start-import-export.md) 섹션을 참조하세요.  
콘텐츠 상속을 사용하여 일부 설명서 부분이 보다 일반적인 사양의 API 엔터티에서 콘텐츠를 상속하도록 허용할 수도 있습니다. 자세한 내용은 [API Gateway에 API 설명서 표시](api-gateway-documenting-api-content-representation.md) 섹션을 참조하세요.

**API Gateway 리소스 정책의 길이(문자 수 단위)**  
리소스 정책의 길이를 줄이기 위해 AWS WAFV2를 사용하여 API를 보호합니다. 자세한 내용은 [API Gateway에서 AWS WAF를 사용하여 REST API 보호](apigateway-control-access-aws-waf.md) 섹션을 참조하세요.  
정책에 IP 주소가 포함된 경우 특정 값 대신 범위를 사용하여 IP 주소를 정의할 수도 있습니다.

**API 키당 사용량 계획**  
API 키당 사용량 계획 수를 줄이기 위해 사용량 계획당 하나의 API 키를 사용하고 사용량 계획을 여러 API에 연결합니다. 여러 사용량 계획에서 하나의 API 키를 공유하지 않는 것이 좋습니다.