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 指標的配額外，這項指標也會產生配額使用量費用。如果從清單要求中篩除的資源超過 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 區域和可用區方法的所有簡化配額。如要查看區域和可用區方法完整清單，以及追蹤各方法用量的配額指標，請參閱 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 指標的配額外，這項指標也會產生配額使用量費用。如果從清單要求中篩除的資源超過 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
篩選清單費用負擔

配額適用於含有篩選器的 *.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 萬)。
作業讀取要求 (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

要求提高速率配額

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

最佳做法

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

後續步驟