Compute Engine 速率配額和系統限制

這份文件列出 Compute Engine 的頻率配額和系統限制，這些限制會指定您可以對 Compute Engine API 方法提出的要求數。

配額會限制 Google Cloud 專案可使用的資源數量，如要變更配額值，以因應更多資源用量，可以申請調整配額。系統限制是固定的限制條件，無法增加或減少。詳情請參閱「Cloud Quotas 總覽」。

速率配額和系統限制

頻率配額 (也稱為 API 配額) 定義了可對 Compute Engine API 發出的要求數。這些配額是以專案為單位計算。每項配額都適用於一或多個 Compute Engine API 方法的群組。使用 gcloud CLI 或 Google Cloud 控制台時，也是在向 API 發出要求，這些要求會計入您的頻率配額中。如果使用服務帳戶存取 API，相關要求也會計入頻率配額中。

Google 會針對每個群組，每分鐘強制執行配額限制。如果專案在 60 秒內達到 API 要求數上限，您必須等待該頻率配額重新填滿，才能在該群組中提出更多要求。舉例來說，如果專案在 10:00:15 達到配額上限，配額會在下一個同步間隔開始時 (例如 10:01:00) 重新填滿，而不是立即填滿。如果專案超出頻率配額，您會收到 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
每分鐘快取撤銷要求數 (GlobalCacheInvalidationRequestsPerMinutePerProject)
全球 UrlMapsService.InvalidateCache 方法的配額。 		compute.googleapis.com/global_cache_invalidation_requests

下表列出 Compute Engine API 的系統限制和指標：

系統限制和說明 指標名稱
每分鐘可用的要求數 (GlobalListUsablePerMinutePerProject)
全球 ListUsable 方法的系統限制。 		compute.googleapis.com/list_usable_requests
篩選清單費用負擔 (ListRequestsFilterCostOverheadPerMinutePerProject)

系統對附帶篩選器的 *.list 和 *.aggregatedList 全域方法設有限制。

Google Cloud 除了 compute.googleapis.com/global_reads 指標的配額外，這項指標也會產生配額使用量費用。如果從清單要求中篩除的資源超過 1 萬個，您就需要支付配額費用。如果超過配額上限，Compute Engine API 會拒絕清單要求。

 compute.googleapis.com/filtered_list_cost_overhead
每項專案的頻率： 每個區域每分鐘從清單要求中篩除 75 萬項資源。由於每 1 萬項資源會收取配額費用，因此在 Google Cloud 控制台上查詢這項配額限制時，您會看到上限為 75 (75 萬/1 萬)。
每分鐘要求數 (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 區域和區域方法的簡化 API 配額指標：如要查看區域和區域方法的完整清單，以及追蹤各方法用量的配額指標，請參閱 Compute Engine API 配額指標參考資料。

配額和說明 指標名稱
每個地區每分鐘的讀取要求數 (ReadRequestsPerMinutePerProjectPerRegion)
區域和可用區 `get` 和 `list` 方法的配額。		 compute.googleapis.com/reads_per_region
每個地區的寫入要求數 (WritesPerMinutePerProjectPerRegion)
不屬於其他配額指標的區域和可用區寫入方法配額。 		compute.googleapis.com/writes_per_region

下表列出 Compute Engine API 地區和區域方法的系統限制：

系統限制和說明 指標名稱
列出每個地區可用的要求 (ListUsablePerMinutePerProjectPerRegion)
地區和區域 ListUsable 方法的系統限制。 		compute.googleapis.com/list_usable_requests_per_region
各區域的篩選清單費用額外負擔

系統限制：使用篩選條件的 *.list 和 *.aggregatedList 區域和可用區方法。

Google Cloud 除了 compute.googleapis.com/reads_per_region 指標的配額外，這項指標也會產生配額使用量費用。如果從清單要求中篩除的資源超過 1 萬個，您就需要支付配額費用。如果超過這個上限，Compute Engine API 會拒絕清單要求。

 compute.googleapis.com/filtered_list_cost_overhead_per_region
每項專案的頻率 (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion)： 每分鐘每個區域的清單要求中，有 75 萬項資源遭到篩除。由於每 1 萬項資源會收取配額費用，因此在 Google Cloud 控制台上查詢這項配額限制時，您會看到上限為 75 (75 萬/1 萬)。
每個區域的每分鐘要求數 (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
作業讀取要求 (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
patch、delete 和 insert 方法的配額，適用於 interconnectAttachments 資源和 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

下表列出 Compute Engine API 地區和區域方法的舊版系統限制：

系統限制和說明 指標名稱
篩選清單費用負擔

使用篩選條件的 *.list 和 *.aggregatedList 方法的系統限制。

除了 compute.googleapis.com/list_requests_per_region 和 compute.googleapis.com/heavy_weight_read_requests_per_region 指標的配額外，Google Cloud 也會針對這項指標的配額用量收費。如果從清單要求中篩除的資源超過 1 萬個，您就需要支付配額費用。如果超過這個上限，Compute Engine API 會拒絕清單要求。

 compute.googleapis.com/filtered_list_cost_overhead_per_region
每項專案的頻率 (ListRequestsFilterCostOverheadPerMinutePerProjectPerRegion)： 每分鐘每個區域的清單要求中，有 75 萬項資源遭到篩除。由於每 1 萬項資源會計入配額，因此在 Google Cloud 控制台上查詢這項配額限制時，會看到上限為 75 (75 萬/1 萬)。

要求提高速率配額

如要提高 API 要求的配額，請透過 Google Cloud 主控台申請增加 API 配額。如需操作說明，請參閱「要求調整配額」。

最佳做法

請遵循 Compute Engine API 最佳做法保留速率配額，以減輕速率配額的影響。

後續步驟