本文档列出了 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 发出的请求数由配额组定义,如下表所示。每个组均单独计算,因此您可以同时达到每个组的最大配额。
全局指标的速率配额
除非另有说明,否则以下配额组适用于所有资源:
配额组 说明 |
指标名称 | 默认配额 |
---|---|---|
查询 未包含在其他配额指标下的全球变更方法的配额。 以下
|
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 个请求/分钟 |
过滤后的列表费用开销 带有过滤条件的
除了 |
compute.googleapis.com/filtered_list_cost_overhead |
每个项目的速率 (ListRequestsFilterCostOverheadPerMinutePerProject ):每分钟每个区域从列表中过滤出 75 万个资源。由于配额按每 1 万个资源计费,因此在 Google Cloud 控制台中查询此配额限制时,您会看到限制为 75(75 万/1 万)。
|
全球性资源变更请求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 |
读取请求 区域和可用区 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 |
过滤后的列表费用开销 带有过滤条件的
除了 |
compute.googleapis.com/filtered_list_cost_overhead_per_region (BETA 版) |
每个项目的速率 (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion ):每分钟每个区域从列表中过滤出 75 万个资源。由于配额按每 1 万个资源计费,因此在 Google Cloud 控制台中查询此配额限制时,您会看到限制为 75(75 万/1 万)。
|
操作读取请求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 使用情况。
- 了解如何设置配额提醒。