Compute Engine 비율 할당량

이 문서에서는 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에 수행할 수 있는 요청 수는 다음 표에 설명된 것처럼 API 할당량으로 정의됩니다. 각 그룹은 개별적으로 계산되므로 각 그룹에서 동시에 최대 할당량에 도달할 수 있습니다.

전역 메서드의 비율 할당량

다음 섹션에는 전역 Compute Engine API 메서드에 대해 요청할 수 있는 수를 정의하는 할당량이 나와 있습니다.

전역 메서드의 간소화된 API 할당량

Compute Engine API 할당량의 검색 가능성과 관리성을 개선하기 위해Google Cloud 측정항목을 더 적은 수의 할당량으로 통합하여 할당량 측정항목 수를 줄였습니다. 이러한 간소화된 할당량 측정항목은 각 할당량에 더 높은 한도를 제공합니다.

전역 메서드의 전체 목록과 각 메서드의 비용을 추적하는 할당량 측정항목을 보려면 Compute Engine API 할당량 측정항목 참조를 참조하세요.

다음 표에는 Compute Engine API의 모든 간소화된 API 할당량 측정항목이 나와 있습니다.

할당량
할당량 설명		 측정항목 이름
분당 읽기 요청 수(GlobalReadsPerMinutePerProject)
전역 get 및 list 메서드의 할당량입니다. 		compute.googleapis.com/global_reads
분당 쓰기 요청 수(GlobalWritesPerMinutePerProject)
다른 할당량 측정항목에 포함되지 않는 전역 쓰기 메서드의 할당량입니다. 		compute.googleapis.com/global_writes
분당 사용 가능한 목록 요청 수(GlobalListUsablePerMinutePerProject)
전역 ListUsable 메서드의 할당량입니다. 		compute.googleapis.com/list_usable_requests
분당 캐시 무효화 요청 수(GlobalCacheInvalidationRequestsPerMinutePerProject)
전역 UrlMapsService.InvalidateCache 메서드의 할당량 		compute.googleapis.com/global_cache_invalidation_requests
필터링된 목록 비용 오버헤드(ListRequestsFilterCostOverheadPerMinutePerProject)

필터가 있는 *.list 및 *.aggregatedList 전역 메서드에 대한 할당량입니다.

Google Cloud 는 compute.googleapis.com/global_reads 측정항목에 대한 할당량과 함께 이 측정항목에 대한 할당량 사용에 대한 요금을 청구합니다. 목록 요청에서 필터링된 리소스가 10,000개를 초과하면 할당량 요금이 발생합니다. 이 할당량 한도를 초과하면 Compute Engine API에서 목록 요청을 거부합니다.

 compute.googleapis.com/filtered_list_cost_overhead
프로젝트당 비율: 리전별 분당 목록 요청에서 필터링된 리소스 750,000개입니다. 리소스 10,000개마다 할당량이 청구되므로 Google Cloud 콘솔에서 이 할당량 한도를 쿼리할 때 한도가 75(750,000/10,000)로 표시됩니다.
분당 요청 수(GlobalRequestsPerMinutePerProject)

모든 전역 읽기 및 쓰기 요청의 할당량입니다.

 compute.googleapis.com/global_requests

전역 메서드의 기존 API 할당량

다음 표에는 전역 메서드의 모든 Compute Engine API 할당량이 나와 있습니다.

할당량
할당량 설명		 측정항목 이름
분당 쿼리 수(defaultPerMinutePerProject)
다른 할당량 측정항목에 포함되지 않는 전역 목록 및 변형 메서드의 할당량

다음 get 메서드도 이 default 측정항목을 사용합니다.

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
 compute.googleapis.com/default
읽기 요청(기존)(ReadRequestsPerMinutePerProject)
전역 *.get 메서드의 할당량입니다.		 compute.googleapis.com/read_requests
나열 요청(ListRequestsPerMinutePerProject)
전역 *.list 메서드의 할당량		 compute.googleapis.com/list_requests
작업 읽기 요청(OperationReadRequestsPerMinutePerProject)
globalOperations.get 메서드의 할당량		 compute.googleapis.com/operation_read_requests
전역 리소스 변형 요청(GlobalResourceWriteRequestsPerMinutePerProject)
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
대량의 변형 요청(HeavyWeightWriteRequestsPerMinutePerProject)
interconnects 리소스에 대한 patch, delete, insert 메서드의 할당량		 compute.googleapis.com/heavy_weight_write_requests
대량의 읽기 요청(HeavyWeightReadRequestsPerMinutePerProject)
*.aggregatedList 메서드의 할당량		 compute.googleapis.com/heavy_weight_read_requests

메서드별 할당량이 적용되는 전역 API에는 다음 할당량이 적용됩니다.

할당량
할당량 설명		 측정항목 이름 기본 한도
라이선스 삽입 요청
licenses.insert 메서드의 할당량		 compute.googleapis.com/license_insert_requests
  • 프로젝트당 할당량(LicenseInsertRequestsPerMinutePerProject): 초당 2.5개 요청(분당 150개 요청)
  • 프로젝트당 일일 할당량(LicenseInsertRequestsPerDayPerProject): 하루 30개 요청
프로젝트 설정 공통 인스턴스 메타데이터 요청 수
projects.setCommonInstanceMetadata 메서드의 할당량		 compute.googleapis.com/project_set_common_instance_metadata_requests 프로젝트당 할당량(ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject): 분당 36개 요청

리전 및 영역 메서드의 비율 할당량

다음 섹션에는 리전 측정항목을 사용하는 메서드에 적용되는 모든 할당량이 나와 있습니다.

리전 및 영역 메서드의 간소화된 API 할당량

다음 표에는 Compute Engine API 리전 및 영역 메서드의 모든 간소화된 할당량이 나와 있습니다. 리전 및 영역 메서드의 전체 목록과 각 메서드의 사용량을 추적하는 할당량 측정항목을 보려면 Compute Engine API 할당량 측정항목 참조를 확인하세요.

할당량
할당량 설명		 측정항목 이름
리전별 분당 읽기 요청 수(ReadRequestsPerMinutePerProjectPerRegion)
리전 및 영역 `get` 및 `list` 메서드의 할당량입니다.		 compute.googleapis.com/reads_per_region
리전별 쓰기 요청(WritesPerMinutePerProjectPerRegion)
다른 할당량 측정항목에 포함되지 않는 리전 및 영역 쓰기 메서드의 할당량입니다. 		compute.googleapis.com/writes_per_region
리전별로 사용 가능한 요청 나열 (ListUsablePerMinutePerProjectPerRegion)
리전 및 영역 ListUsable 메서드의 할당량입니다. 		compute.googleapis.com/list_usable_requests_per_region
리전별 필터링된 목록 비용 오버헤드

필터가 있는 *.list 및 *.aggregatedList 리전 및 영역 메서드에 대한 할당량입니다.

Google Cloud 는 compute.googleapis.com/reads_per_region 측정항목에 대한 할당량과 함께 이 측정항목에 대한 할당량 사용에 대한 요금을 청구합니다. 목록 요청에서 필터링된 리소스가 10,000개를 초과하면 할당량 요금이 발생합니다. 이 할당량 한도를 초과하면 Compute Engine API에서 목록 요청을 거부합니다.

 compute.googleapis.com/filtered_list_cost_overhead_per_region
프로젝트당 비율(ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 리전별 분당 목록 요청에서 필터링된 리소스 750,000개입니다. 리소스 10,000개마다 할당량이 청구되므로 Google Cloud 콘솔에서 이 할당량 한도를 쿼리할 때 한도가 75(750,000/10,000)로 표시됩니다.
리전별 분당 요청(RequestsPerMinutePerProjectPerRegion)

모든 리전 읽기 및 쓰기 요청의 할당량입니다.

 compute.googleapis.com/requests_per_region

리전 메서드의 기존 API 할당량

다음 표에는 리전 및 영역 메서드의 모든 Compute Engine API 할당량이 나와 있습니다.

할당량
할당량 설명		 측정항목 이름
쿼리(QueriesPerMinutePerRegion)
Compute Engine 리소스를 생성, 수정 또는 삭제하는 리전 및 영역 메서드에 대한 할당량입니다. 예를 들면 instances.insert, disks.update, instances.delete 메서드입니다.

다음 get, list, patch 메서드에도 이 default_per_region 측정항목이 사용됩니다.

  • projects.listXpnHosts
  • instances.getScreenshot
  • instances.getGuestAttributes
  • instances.getShieldedInstanceIdentity
  • instances.getEffectiveFirewalls
  • projects.listXpnHosts
  • instanceGroupManagers.listManagedInstances
  • instanceGroupManagers.listErrors
  • instanceGroupManagers.listPerInstanceConfigs
  • regionInstanceGroupManagers.listManagedInstances
  • regionInstanceGroupManagers.listErrors
  • regionInstanceGroupManagers.listPerInstanceConfigs
  • resourcePolicies.patch
 compute.googleapis.com/default_per_region
읽기 요청(기존)(ReadRequestsPerMinutePerRegion)
autoscalers.get, disks.get, instances.get, machineTypes.get 같은 리전 및 영역 get 메서드의 할당량입니다.		 compute.googleapis.com/read_requests_per_region
나열 요청(ListRequestsPerMinutePerRegion)
autoscalers.list, disks.list, instances.list, machineTypes.list 같은 리전 및 영역 list 메서드의 할당량입니다.		 compute.googleapis.com/list_requests_per_region
필터링된 목록 비용 오버헤드

필터가 있는 *.list 및 *.aggregatedList 메서드에 대한 할당량입니다.

Google Cloud 는 compute.googleapis.com/list_requests_per_region 및 compute.googleapis.com/heavy_weight_read_requests_per_region 측정항목에 대한 할당량과 함께 이 측정항목에 대한 할당량 사용에 대한 요금을 청구합니다. 목록 요청에서 필터링된 리소스가 10,000개를 초과하면 할당량 요금이 발생합니다. 이 할당량 한도를 초과하면 Compute Engine API에서 목록 요청을 거부합니다.

 compute.googleapis.com/filtered_list_cost_overhead_per_region
프로젝트당 비율(ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion): 리전별 분당 목록 요청에서 필터링된 리소스 750,000개입니다. 리소스 10,000개마다 할당량이 청구되므로 Google Cloud 콘솔에서 이 할당량 한도를 쿼리할 때 한도가 75(750,000/10,000)로 표시됩니다.
작업 읽기 요청(OperationReadRequestsPerMinutePerRegion)
regionOperations.get 및 zoneOperations.get 메서드의 할당량입니다.		 compute.googleapis.com/operation_read_requests_per_region
리전별 전역 리소스 변형 요청(GlobalResourceWriteRequestsPerMinutePerProjectPerRegion)
disks.createSnapshot 및 regionDisks.createSnapshot 메서드의 할당량입니다.		 compute.googleapis.com/global_resource_write_requests_per_region
인스턴스 가져오기 직렬 포트 출력 요청(GetSerialPortOutputRequestsPerMinutePerProjectPerRegion)
instances.getSerialPortOutput 메서드의 할당량입니다.		 compute.googleapis.com/get_serial_port_output_requests_per_region
대량의 읽기 요청(HeavyWeightReadRequestsPerMinutePerRegion)
regionOperations.wait, zoneOperations.wait, regionNetworkFirewallPolicies.getEffectiveFirewalls 메서드의 할당량입니다.		 compute.googleapis.com/heavy_weight_read_requests_per_region
대량의 리전별 변형 요청 HeavyWeightWriteRequestsPerMinutePerProjectPerRegion
interconnectAttachments 리소스에 대한 patch, delete,insert 메서드 및 networks.updatePeering 메서드의 할당량입니다.		 compute.googleapis.com/heavy_weight_write_requests_per_region
인스턴스 시뮬레이션된 유지보수 이벤트 요청(SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion)
instances.simulateMaintenanceEvent메서드의 할당량입니다.		 compute.googleapis.com/simulate_maintenance_event_requests_per_region
인스턴스 나열 리퍼러 요청 InstanceListReferrersRequestsPerMinutePerProjectPerRegion
instances.listReferrers 메서드의 할당량입니다.		 compute.googleapis.com/instance_list_referrers_requests_per_region
네트워크 엔드포인트 쓰기 요청 NetworkEndpointWriteRequestsPerMinutePerProjectPerRegion
networkEndpointGroups.attachNetworkEndpoints및 networkEndpointGroups.detachNetworkEndpoints 메서드의 할당량입니다.		 compute.googleapis.com/network_endpoint_write_requests_per_region
네트워크 엔드포인트 나열 요청(NetworkEndpointListRequestsPerMinutePerProjectPerRegion)
networkEndpointGroups.listNetworkEndpoints 메서드의 할당량입니다.		 compute.googleapis.com/network_endpoint_list_requests_per_region
리전 네트워크 엔드포인트 쓰기 요청(RegionalNetworkEndpointWriteRequestsPerMinutePerProjectPerRegion)
regionNetworkEndpointGroups.attachNetworkEndpoints 및 regionNetworkEndpointGroups.detachNetworkEndpoints 메서드의 할당량입니다.		 compute.googleapis.com/regional_network_endpoint_write_requests_per_region
리전 네트워크 엔드포인트 나열 요청(RegionalNetworkEndpointListRequestsPerMinutePerProjectPerRegion)
regionNetworkEndpointGroups.listNetworkEndpoints 메서드의 할당량입니다.		 compute.googleapis.com/regional_network_endpoint_list_requests_per_region

비율 할당량 상향 요청

API 요청에 더 많은 할당량이 필요한 경 우 Google Cloud 콘솔에서 API 할당량 증가를 요청할 수 있습니다. 자세한 내용은 할당량 조정 요청을 참조하세요.

권장사항

비율 할당량에 따른 영향을 완화하려면 비율 할당량 보존에 대한 Compute Engine API 권장사항을 따르세요.

다음 단계