REST API 구성 및 실행에 대한 API Gateway 할당량
Amazon API Gateway에서의 REST API 구성 및 실행에는 다음 할당량이 적용됩니다. 할당량이 API별로 적용되는 경우, 계정의 모든 API가 아닌 특정 API에 대해서만 할당량을 늘릴 수 있습니다.
계정 수준 할당량에 대한 자세한 내용은 Amazon API Gateway 할당량 섹션을 참조하세요.
| 리소스 또는 작업 | 기본 할당량 | 높일 수 있음 |
|---|---|---|
| 리전별 계정당 퍼블릭 사용자 지정 도메인 이름 | 120 | 예 |
| 리전별 계정당 프라이빗 사용자 지정 도메인 이름 | 50 | 예 |
| 리전별 리전 API | 600 | 아니요 |
| 리전별 엣지 최적화 API | 120 | 아니요 |
| 리전별 계정당 프라이빗 API | 600 | 아니요 |
| 계정당 도메인 이름 액세스 연결 | 100 | 예 |
| 도메인별 멀티 레벨 API 매핑 | 200 | 아니요 |
| 도메인당 라우팅 규칙 | 50 | 예 |
| 엣지 최적화된 API에 대한 URL의 길이(문자 수) | 8192 | 아니요 |
| 지역 API에 대한 URL의 길이(문자 수) | 10240 | 아니요 |
| API Gateway 리소스 정책의 길이(문자 수 단위) | 8192 | 예 |
| 리전별 계정당 API 키 | 10000 | 아니요 |
| 리전별 계정당 클라이언트 인증서 | 60 | 예 |
| API별 권한 부여자(AWS Lambda 및 Amazon Cognito) | 10 |
예 이 할당량을 늘리려면 AWS Support Center |
| API당 설명서 부분 | 2000 |
예 이 할당량을 늘리려면 AWS Support Center |
| API당 리소스 | 300 | 예 |
| API당 단계 | 10 | 예 |
| 단계별 단계 변수 | 100 | 아니요 |
| 단계 변수의 키의 길이(문자 수) | 64 | 아니요 |
| 단계 변수의 값의 길이(문자 수) | 512 | 아니요 |
| 리전별 계정당 사용량 계획 | 300 | 예 |
| API 키당 사용량 계획 | 10 | 예 |
| 리전별 계정당 VPC 링크 | 20 | 예 |
| API 캐싱 TTL | 기본적으로 300초이고 API 소유자가 0~3600으로 구성 가능합니다. | 상한용이 아님(3600) |
| 캐싱된 응답 크기 | 1048576바이트 캐시 데이터 암호화는 캐싱되는 항목의 크기를 증가시킬 수 있습니다. | 아니요 |
| 리전 API의 통합 제한 시간 | Lambda, Lambda 프록시, HTTP, HTTP 프록시 및 AWS 통합을 포함하는 모든 통합 유형의 경우, 50밀리초 - 29초. | 예 * |
| 엣지 최적화 API의 통합 제한 시간 | Lambda, Lambda 프록시, HTTP, HTTP 프록시 및 AWS 통합을 포함하는 모든 통합 유형의 경우, 50밀리초 - 29초. | 아니요 |
| 프라이빗 API의 통합 제한 시간 | Lambda, Lambda 프록시, HTTP, HTTP 프록시 및 AWS 통합을 포함하는 모든 통합 유형의 경우, 50밀리초 - 29초. | 예 * |
| 헤더 이름, 값, 행 종결자(있는 경우) 및 공백을 포함한 모든 헤더 값의 총크기 | 10240바이트 | 아니요 |
| 프라이빗 API의 경우 모든 헤더 값의 전체 결합 크기 | 8000바이트 | 아니요 |
| 페이로드 크기 | 10MB | 아니요 |
| 단계당 태그 수 | 50 | 아니요 |
매핑 템플릿의 #foreach ... #end 루프의 반복 횟수 |
1000 | 아니요 |
| 최대 매핑 템플릿 크기 | 300KB | 아니요 |
| 메서드 ARN 길이 | 1600바이트. 메서드에 경로 파라미터가 포함되어 있고 클라이언트가 ARN 길이를 초과하는 값을 사용하는 경우 API는 414 Request URI too long 응답을 반환합니다. |
아니요 |
| 사용량 계획의 단계에 대한 메서드 수준 제한 설정 | 20 |
예 이 할당량을 늘리려면 AWS Support Center |
| API당 모델 크기 | 400KB | 아니요 |
| 트러스트 스토어에 있는 인증서 수 | 인증서 1,000개(총 개체 크기 최대 1MB) | 아니요 |
| 유휴 연결 제한 시간 | 310초 | 아니요 |
| restapi:import 또는 restapi:put 사용 시 최대 API 정의 파일 크기 | 6MB | 아니요 |
* 통합 제한 시간은 50밀리초 미만으로 설정할 수 없습니다. 통합 제한 시간을 29초가 넘도록 늘릴 수 있지만, 이렇게 하려면 계정의 리전 수준 스로틀링 할당량을 줄여야 할 수 있습니다.
할당량 감소를 위한 모범 사례
다음 모범 사례는 현재 리소스를 줄여 할당량 증가를 방지하는 데 도움이 될 수 있습니다. 이러한 제안 사항이 해당 API 아키텍처에 적합한지 확인하세요.
- 리전당 API
-
리전당 API 수를 줄이기 위해 사용하지 않는 API를 모두 내보낸 다음 API Gateway에서 삭제합니다. 자세한 내용은 API Gateway에서 REST API 내보내기 섹션을 참조하세요.
- API당 단계
-
API당 스테이지 수를 줄이기 위해 API를 여러 개의 API로 분할합니다.
- API당 리소스
-
{proxy+}경로를 사용하여 리소스 수를 줄입니다. 자세한 내용은 프록시 리소스를 사용하여 프록시 통합 설정 섹션을 참조하세요. - API 매핑
-
사용자 지정 도메인 이름에 대한 API 매핑 수를 줄이기 위해
/prod와 같은 단일 수준의 API 매핑을 사용합니다. 단일 수준의 API 매핑은 API 매핑 할당량에 포함되지 않습니다. - API별 권한 부여자
API당 권한 부여자 수를 줄이기 위해 API 메서드에서 권한 부여자를 재사용합니다.
- API당 설명서 부분
-
API당 설명서 부분 수를 줄이기 위해 API를 가져올 때
ignore=documentation을 사용합니다. 자세한 내용은 API 설명서 가져오기 섹션을 참조하세요.콘텐츠 상속을 사용하여 일부 설명서 부분이 보다 일반적인 사양의 API 엔터티에서 콘텐츠를 상속하도록 허용할 수도 있습니다. 자세한 내용은 API Gateway에 API 설명서 표시 섹션을 참조하세요.
- API Gateway 리소스 정책의 길이(문자 수 단위)
-
리소스 정책의 길이를 줄이기 위해 AWS WAFV2를 사용하여 API를 보호합니다. 자세한 내용은 API Gateway에서 AWS WAF를 사용하여 REST API 보호 섹션을 참조하세요.
정책에 IP 주소가 포함된 경우 특정 값 대신 범위를 사용하여 IP 주소를 정의할 수도 있습니다.
- API 키당 사용량 계획
-
API 키당 사용량 계획 수를 줄이기 위해 사용량 계획당 하나의 API 키를 사용하고 사용량 계획을 여러 API에 연결합니다. 여러 사용량 계획에서 하나의 API 키를 공유하지 않는 것이 좋습니다.
