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 提出的要求數量，是由 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
每個專案的頻率： 每分鐘從每個區域的清單要求中篩除 75 萬個資源。由於配額是按每 10, 000 個資源收費，因此在 Google Cloud 主控台上查詢這個配額限制時，您會看到限制為 75 (750k/10k)。
每分鐘的要求次數 (GlobalRequestsPerMinutePerProject)

所有全域讀取和寫入要求的配額。

 compute.googleapis.com/global_requests

全域方法的舊版 API 配額

下表列出全域方法的所有 Compute Engine API 配額。

配額
配額說明		 指標名稱
每分鐘查詢次數 (defaultPerMinutePerProject)
global-list 和 mutation 方法的配額，不包含在其他配額指標中。

下列 get 方法也使用這個 default 指標：

  • networkFirewallPolicies.get
  • projects.getXpnHost
  • projects.getXpnResources
 compute.googleapis.com/default
讀取要求 (ReadRequestsPerMinutePerProject)
global *.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
per project (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion)： 每分鐘從每個區域的清單要求中篩除 75 萬個資源。由於配額是按每 10, 000 個資源收費，因此在 Google Cloud 主控台上查詢這個配額限制時，您會看到限制為 75 (750k/10k)。
每個地區的每分鐘要求數 (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
區域和區域 get 方法的配額，例如 autoscalers.get、disks.get、instances.get 和 machineTypes.get。		 compute.googleapis.com/read_requests_per_region
清單要求 ListRequestsPerMinutePerRegion
區域和區域性 list 方法的配額，例如 autoscalers.list、disks.list、instances.list 和 machineTypes.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)： 每分鐘從每個區域的清單要求中篩除 75 萬個資源。由於配額是按每 10, 000 個資源收費，因此在 Google Cloud 主控台上查詢這個配額限制時，您會看到限制為 75 (750k/10k)。
作業讀取要求 (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 最佳做法，保留費率配額，以減輕費率配額的影響。

後續步驟