이 문서에서는 Compute Engine API 메서드에 대해 요청할 수 있는 수를 정의하는 Compute Engine 속도 할당량을 나열합니다.
비율 할당량
비율 할당량(API 비율 제한 또는 API 할당량이라고도 함)은 Compute Engine API에 수행할 수 있는 요청 수를 정의합니다. 이러한 할당량은 프로젝트별로 적용됩니다. 각 할당량은 하나 이상의 Compute Engine API 메서드 그룹에 적용됩니다. gcloud CLI 또는 Google Cloud 콘솔을 사용하면 API에 대한 요청도 실행되며 이러한 요청이 비율 할당량에 반영됩니다. 서비스 계정을 사용하여 API에 액세스할 때도 비율 할당량에 반영됩니다.
Google은 각 그룹에 분 단위(60초) 간격으로 비율 할당량을 적용합니다. 즉, 프로젝트가 60초 내에 언제든지 최대 API 요청 수에 도달하면 해당 그룹에서 요청을 더 수행하기 전에 해당 비율 할당량이 다시 채워질 때까지 기다려야 합니다. 프로젝트가 비율 할당량을 초과하는 경우 rateLimitExceeded 이유와 함께 403 오류가 수신됩니다. 이 오류를 해결하려면 1분을 기다리고 다시 요청을 시도해야 합니다. 다음 간격이 시작될 때 할당량이 다시 채워집니다.
Compute Engine API에 수행할 수 있는 요청 수는 다음 표에 설명된 것처럼 할당량 그룹으로 정의됩니다. 각 그룹은 개별적으로 계산되므로 각 그룹에서 동시에 최대 할당량에 도달할 수 있습니다.
전역 측정항목의 비율 할당량
다음 할당량 그룹은 특별히 지정되지 않은 한 모든 리소스에 적용됩니다.
| 할당량 그룹 설명 |
측정항목 이름 | 기본 할당량 |
|---|---|---|
| 쿼리 전역 변형 메서드의 할당량 다음
|
compute.googleapis.com/default |
프로젝트당 할당량(defaultPerMinutePerProject):
분당 1,500개 요청 |
| 읽기 요청 전역 *.get 메서드의 할당량 |
compute.googleapis.com/read_requests |
프로젝트당 할당량(ReadRequestsPerMinutePerProject):
분당 1,500개 요청 |
| 나열 요청 전역 *.list 메서드의 할당량 |
compute.googleapis.com/list_requests |
프로젝트당 할당량(ListRequestsPerMinutePerProject):
분당 1,500개 요청 |
작업 읽기 요청globalOperations.get 메서드의 할당량 |
compute.googleapis.com/operation_read_requests |
프로젝트당 비율(OperationReadRequestsPerMinutePerProject):
분당 1,500개 요청 |
| 필터링된 목록 비용 오버헤드 필터가 있는 Google Cloud는 |
compute.googleapis.com/filtered_list_cost_overhead베타 |
프로젝트당 비율(ListRequestsFilterCostOverheadPerMinutePerProject): 분당 750,000개 필터링된 리소스 |
전역 리소스 변형 요청images.delete, images.deprecate, images.insert, images.setLabels, snapshots.delete, snapshots.insert, snapshots.setLabels, machineImages.insert, machineImages.delete 메서드의 할당량 |
compute.googleapis.com/global_resource_write_requests |
프로젝트당 비율(GlobalResourceWriteRequestsPerMinutePerProject):
분당 375개 요청 |
대량의 변형 요청interconnects 리소스에 대한 patch, delete, insert 메서드 할당량 |
compute.googleapis.com/heavy_weight_write_requests |
프로젝트당 비율(HeavyWeightWriteRequestsPerMinutePerProject):
분당 750개 요청 |
대량의 읽기기 요청*.aggregatedList 메서드의 할당량 |
compute.googleapis.com/heavy_weight_read_requests |
프로젝트당 비율(HeavyWeightReadRequestsPerMinutePerProject):
분당 750개 요청 |
메서드당 할당량이 적용되는 전역 API에는 다음과 같은 할당량 그룹이 적용됩니다.
| 할당량 그룹 설명 |
측정항목 이름 | 기본 한도 |
|---|---|---|
라이선스 삽입 요청licenses.insert 메서드의 할당량 |
compute.googleapis.com/license_insert_requests |
|
프로젝트 설정 공통 인스턴스 메타데이터 요청 수projects.setCommonInstanceMetadata 메서드의 할당량 |
compute.googleapis.com/project_set_common_instance_metadata_requests |
프로젝트당 할당량(ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject):
분당 36개 요청 |
리전 측정항목의 비율 할당량
리전 측정항목을 사용하는 메서드에 다음 할당량이 적용됩니다.
| 할당량 그룹 설명 |
측정항목 이름 | 기본 할당량 리전별 프로젝트당 할당량 |
|---|---|---|
| 쿼리 Compute Engine 리소스를 생성, 수정 또는 삭제하는 리전 및 영역 메서드에 대한 할당량입니다. 예를 들면 instances.insert, disks.update, instances.delete 메서드입니다.
다음
|
compute.googleapis.com/default_per_region |
Queries per minute per region: 1500 |
읽기 요청autoscalers.get, disks.get, instances.get, machineTypes.get와 같은 리전 및 영역 get 메서드의 할당량 |
compute.googleapis.com/read_requests_per_region |
Read requests per minute per region: 1500 |
나열 요청autoscalers.list, disks.list, instances.list, machineTypes.list와 같은 리전 및 영역 list 메서드의 할당량 |
compute.googleapis.com/list_requests_per_region |
List requests per minute per region: 1500 |
| 필터링된 목록 비용 오버헤드 필터가 있는 Google Cloud는 |
compute.googleapis.com/filtered_list_cost_overhead_per_region베타 |
프로젝트당 비율(ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 분당 750,000개 필터링된 리소스 |
작업 읽기 요청regionOperations.get 및 zoneOperations.get 메서드의 할당량 |
compute.googleapis.com/operation_read_requests_per_region |
Operation read requests per minute per region: 1500 |
리전별 전역 리소스 변형 요청disks.createSnapshot 및 regionDisks.createSnapshot 메서드의 할당량 |
compute.googleapis.com/global_resource_write_requests_per_region |
GlobalResourceWriteRequestsPerMinutePerProjectPerRegion: 375 |
인스턴스 가져오기 직렬 포트 출력 요청instances.getSerialPortOutput 메서드의 할당량 |
compute.googleapis.com/get_serial_port_output_requests_per_region |
GetSerialPortOutputRequestsPerMinutePerProjectPerRegion: 1500 |
대량의 읽기 요청regionOperations.wait, zoneOperations.wait, regionNetworkFirewallPolicies.getEffectiveFirewalls 메서드의 할당량 |
compute.googleapis.com/heavy_weight_read_requests_per_region |
Heavyweight read requests per minute: 750 |
대량의 리전별 변형 요청interconnectAttachments 리소스에 대한 patch ,delete, insert 메서드 및 networks.updatePeering 메서드의 할당량 |
compute.googleapis.com/heavy_weight_write_requests_per_region |
HeavyWeightWriteRequestsPerMinutePerProjectPerRegion: 750 |
인스턴스 시뮬레이션된 유지보수 이벤트 요청instances.simulateMaintenanceEvent 메서드의 할당량 |
compute.googleapis.com/simulate_maintenance_event_requests_per_region |
SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion: 150 |
인스턴스 나열 리퍼러 요청instances.listReferrers 메서드의 할당량 |
compute.googleapis.com/instance_list_referrers_requests_per_region |
InstanceListReferrersRequestsPerMinutePerProjectPerRegion: 3000 |
네트워크 엔드포인트 쓰기 요청networkEndpointGroups.attachNetworkEndpoints 및 networkEndpointGroups.detachNetworkEndpoints 메서드의 할당량 |
compute.googleapis.com/network_endpoint_write_requests_per_region |
NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 1500 |
네트워크 엔드포인트 나열 요청networkEndpointGroups.listNetworkEndpoints 메서드의 할당량 |
compute.googleapis.com/network_endpoint_list_requests_per_region |
NetworkEndpointListRequestsPerMinutePerProjectPerRegion: 1500 |
리전 네트워크 엔드포인트 쓰기 요청regionNetworkEndpointGroups.attachNetworkEndpoints 및 regionNetworkEndpointGroups.detachNetworkEndpoints 메서드의 할당량 |
compute.googleapis.com/regional_network_endpoint_write_requests_per_region |
RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion: 150 |
리전 네트워크 엔드포인트 나열 요청regionNetworkEndpointGroups.listNetworkEndpoints 메서드의 할당량 |
compute.googleapis.com/regional_network_endpoint_list_requests_per_region |
RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion: 1500 |
비율 할당량 상향 요청
API 요청을 수행하기 위해 더 높은 할당량이 필요한 경우 Google Cloud 콘솔에서 API 할당량 증가를 요청할 수 있습니다. 자세한 내용은 더 높은 할당량 요청을 참조하세요.
권장사항
비율 할당량에 따른 영향을 완화하려면 비율 할당량 보존에 대한 Compute Engine API 권장사항을 따르세요.
다음 단계
- Monitoring API 사용량 알아보기
- 할당량 알림 설정 방법 알아보기