Compute Engine 速率配额

本文档列出了 Compute Engine 速率配额，这些配额定义了您可以向 Compute Engine API 方法发出的请求数。

速率配额

速率配额（也称为 API 速率限制或 API 配额）定义了可向 Compute Engine API 发出的请求数。这些配额按项目计算。每个配额适用于一个或多个 Compute Engine API 方法。使用 gcloud CLI 或 Google Cloud 控制台时，您也会向 API 发出请求，这些请求将计入您的速率配额。如果您使用服务账号访问 API，这也会计入您的速率配额。

Google 对每个组按每分钟（60 秒）时间间隔强制执行速率配额。也就是说，如果您的项目在 60 秒内达到 API 请求数上限，则必须等待该速率配额重新填充，然后才能在该组中发出更多请求。如果您的项目超过速率配额，您会收到 403 错误和原因 rateLimitExceeded。要解决此错误，请等待一分钟再重新发送请求，配额应该会在下一个间隔开始时重新填充。

可以向 Compute Engine API 发出的请求数由配额组定义，如下表所示。每个组均单独计算，因此您可以同时达到每个组的最大配额。

全局指标的速率配额

除非另有说明，否则以下配额组适用于所有资源：

配额组
说明		 指标名称 默认配额
查询
全局变更方法的配额。

以下 get 方法也使用此 default 指标：

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
 compute.googleapis.com/default 每个项目的配额 (defaultPerMinutePerProject)：1500 个请求/分钟
读取请求
全局 *.get 方法的配额。		 compute.googleapis.com/read_requests 每个项目的配额 (ReadRequestsPerMinutePerProject)：1500 个请求/分钟
列出请求
全局 *.list 方法的配额。		 compute.googleapis.com/list_requests 每个项目的配额 (ListRequestsPerMinutePerProject)：1500 个请求/分钟
操作读取请求
globalOperations.get 方法的配额。		 compute.googleapis.com/operation_read_requests 每个项目的速率 (OperationReadRequestsPerMinutePerProject)：1500 个请求/分钟
过滤后的列表费用开销

*.list 和 *.aggregatedList 方法及过滤条件的配额。

除了 compute.googleapis.com/list_requests 和 compute.googleapis.com/heavy_weight_read_requests 指标的配额之外，Google Cloud 还会针对此指标收取配额使用费。如果列出请求中的过滤资源超过 10000 个，则会产生配额费用。如果超出此配额限制，Compute Engine API 会拒绝列出请求。

 compute.googleapis.com/filtered_list_cost_overhead（BETA 版） 每个项目的速率 (ListRequestsFilterCostOverheadPerMinutePerProject)：75 万个过滤资源/分钟
全球性资源变更请求
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
读取请求
区域和可用区 get 方法（例如 autoscalers.get、disks.get、instances.get 和 machineTypes.get）的配额。		 compute.googleapis.com/read_requests_per_region Read requests per minute per region：1500
列出请求
区域和可用区 list 方法（例如 autoscalers.list、disks.list、instances.list 和 machineTypes.list）的配额。		 compute.googleapis.com/list_requests_per_region List requests per minute per region：1500
过滤后的列表费用开销

*.list 和 *.aggregatedList 方法及过滤条件的配额。

除了 compute.googleapis.com/list_requests_per_region 和 compute.googleapis.com/heavy_weight_read_requests_per_region 指标的配额之外，Google Cloud 还会针对此指标收取配额使用费。如果列出请求中的过滤资源超过 10000 个，则会产生配额费用。如果超出此配额限制，Compute Engine API 会拒绝列出请求。

 compute.googleapis.com/filtered_list_cost_overhead_per_region（BETA 版） 每个项目的速率 (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion)：75 万个过滤资源/分钟
操作读取请求
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 最佳实践，以缓解速率配额的影响。

后续步骤