Cloud Quotas API 會將維度表示為鍵/值組合。key
是維度名稱 (例如 region
)。value
是維度的指派值 (例如區域,如 us-central1
)。
舉例來說,Compute Engine 會使用不同維度來計算 VM 使用量。region
維度會測量指定區域中的 VM 數量。Compute Engine 也提供多種產品屬性維度,包括 gpu_family
。gpu_family
維度會測量 Google Cloud 專案中特定系列的 GPU 數量。
查看維度
如要查看配額和系統限制的維度,請前往Google Cloud 控制台、使用 Google Cloud CLI、查詢 REST API 或透過用戶端程式庫。如要查看未指定值的維度,請使用 gcloud CLI。如果專案尚未使用相關聯的資源,您也可以使用 gcloud CLI 查看沒有區域或可用區維度的配額和系統限制維度。本節說明如何使用控制台和 gcloud CLI 查看維度。
控制台
在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「Quotas & System Limits」(配額與系統限制) 頁面:
這個頁面上的表格會在「維度」欄中顯示維度。
如果沒有看到「尺寸」欄,請按照下列步驟操作。 否則請略過這個步驟。
- 按一下「資料欄顯示選項」 。
- 選取「維度」。
- 按一下 [確定]。表格中會顯示「維度」欄。
如要篩選結果,請在「篩選條件」
旁的欄位中輸入屬性名稱或值。- 如要依產品篩選,請開始輸入產品名稱,然後從顯示的清單中選取。
- 如要依維度篩選,請使用下列格式輸入維度:
dimension_name:dimension_value
. 舉例來說,如要查看為 us-central1 區域定義的配額和系統限制,請輸入:region:us-central
。
瞭解空白維度
有時「尺寸」欄會空白。可能原因如下:
配額或系統限制值為預設值,適用於所有維度。對於部分配額和系統限制,控制台會顯示一行,列出預設配額或系統限制值以供參考。由於預設值適用於所有維度值,因此「維度」欄會空白。查看「名稱」欄,找出這些項目。「名稱」欄會以括號在配額或系統限制名稱結尾標示「default」一詞,指出這些項目。
舉例來說,配額
SetIamPolicyRequestsPerMinutePerProject
是在region
維度上定義。控制台會顯示參考項目,以及每個區域的項目。在「名稱」欄中,參照項目會列為「每個區域每分鐘的 SetIAMPolicy 要求數 (預設)」。這個項目的「維度」欄為空白。不適用任何維度。舉例來說,Compute Engine 配額
NETWORKS-per-project
與區域、地帶或產品屬性無關,因此不會顯示任何維度。
gcloud
您可以使用 gcloud CLI 查看單一配額或系統限制的維度,也可以查看與特定產品相關的所有配額和系統限制。查看單一配額或系統限制的維度,通常會比查看與產品相關聯的所有配額和系統限制維度更快。單一配額的查詢回應通常約有 200 行。產品查詢的回覆最多可達 2,000 行。
使用 gcloud 查看單一配額或系統限制的維度
如要使用 gcloud CLI 查看單一配額或系統限制的維度,請在終端機中執行下列指令:
gcloud beta quotas info describe QUOTA_ID --project=PROJECT_ID --service=SERVICE_ID
更改下列內容:
QUOTA_ID
:配額或系統限制的 ID。如果您不知道配額 ID,請選擇下列其中一個選項:- 如要找出配額 ID,請按照「找出配額 ID」一文的說明使用控制台。
- 查看與配額或系統限制相關的產品所有維度。這項指令不需要配額 ID。 請參閱「使用 gcloud CLI 查看產品的尺寸」一節。
PROJECT_ID
:專案的 ID。 Google Cloud如要找出專案 ID,請選擇下列其中一個選項:- 如要使用控制台找出專案 ID,請參閱「識別專案」。
- 如果您在 gcloud CLI 設定中將目前專案設為預設專案,請在終端機中執行下列 gcloud 指令,找出專案 ID:
gcloud config get-value project
SERVICE_ID
:與配額或系統限制相關聯的產品服務 ID。舉例來說,如果配額適用於 Compute Engine A2 CPU,服務 ID 為compute.googleapis.com
。
使用 gcloud CLI 查看產品尺寸
如要使用 gcloud CLI 查看單一配額或系統限制的維度,請在終端機中執行下列指令:
gcloud beta quotas info list --project=PROJECT_ID --service=SERVICE_ID
更改下列內容:
PROJECT_ID
:專案的 ID。 Google Cloud如要找出專案 ID,請選擇下列其中一個選項:- 如要使用控制台找出專案 ID,請參閱「識別專案」。
- 如果您在 gcloud CLI 設定中將目前專案設為預設專案,請在終端機中執行下列 gcloud 指令,找出專案 ID:
gcloud config get-value project
SERVICE_ID
:與配額或系統限制相關聯的產品服務 ID。舉例來說,如果配額適用於 Compute Engine A2 CPU,服務 ID 為compute.googleapis.com
。
維度優先順序
Cloud Quotas API 的部分用途需要複雜的維度設定。配額的設定層級比地區和區域更精細。使用服務專屬維度時,即可達到這種精細程度。
舉例來說,gpu_family
和 network_id
是 Compute Engine 服務中的服務專屬維度。維度是由各項服務分別定義,每項服務可能有一組不同的服務專屬維度。
使用位置維度或服務專屬維度時,系統會套用下列優先順序:
如果配額偏好設定指定了所有位置和服務專屬維度,則會優先於任何其他設定。
指定位置維度的設定只會優先於僅包含服務專屬維度的設定。
合併維度
在配額偏好設定中,您可以透過下列方式組合維度:
設定可能同時包含位置維度和服務專屬維度。這是優先順序最高的規則。
設定只能包含位置尺寸。這項設定適用於所有服務專屬維度,但以方法 1 明確設定的維度除外。
設定只能包含服務專屬維度。這項設定適用於所有位置,但以方法 1 或 2 明確設定的位置除外。
如果設定包含任何服務專屬維度,就必須包含所有服務專屬維度。
您可以設定不含任何維度的設定。這類設定會套用至所有地點和所有服務專屬維度,明確設定的維度除外。