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

전역 측정항목의 비율 할당량

다음 할당량 그룹은 특별히 지정되지 않은 한 모든 리소스에 적용됩니다.

할당량 그룹
설명		 측정항목 이름 기본 할당량
쿼리
다른 할당량 측정항목에 포함되지 않는 전역 변형 메서드의 할당량

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

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
 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개 요청
필터링된 목록 비용 오버헤드

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

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

 compute.googleapis.com/filtered_list_cost_overhead 프로젝트당 비율(ListRequestsFilterCostOverheadPerMinutePerProject): 리전별 분당 목록 요청에서 필터링된 리소스 750,000개입니다. 리소스 10,000개마다 할당량이 청구되므로 Google Cloud 콘솔에서 이 할당량 한도를 쿼리할 때 한도가 75(750,000/10,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
  • 프로젝트당 할당량(LicenseInsertRequestsPerMinutePerProject): 초당 2.5개 요청(분당 150개 요청)
  • 프로젝트당 일일 할당량(LicenseInsertRequestsPerDayPerProject): 하루 30개 요청
프로젝트 설정 공통 인스턴스 메타데이터 요청 수
projects.setCommonInstanceMetadata 메서드의 할당량		 compute.googleapis.com/project_set_common_instance_metadata_requests 프로젝트당 할당량(ProjectSetCommonInstanceMetadataRequestsPerMinutePerProject): 분당 36개 요청

리전 측정항목의 비율 할당량

리전 측정항목을 사용하는 메서드에 다음 할당량이 적용됩니다.

할당량 그룹
설명		 측정항목 이름 기본 할당량
리전별 프로젝트당 할당량
쿼리
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 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
필터링된 목록 비용 오버헤드

필터가 있는 *.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)로 표시됩니다.
작업 읽기 요청
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 권장사항을 따르세요.

다음 단계