查看及管理配額

本文說明如何在Google Cloud 控制台中查看配額值。您也可以透過Google Cloud 控制台、Cloud Quotas API 和 Google Cloud CLI (gcloud CLI) 管理配額。

限制

Cloud Quotas 具有下列限制:

  • 在大多數情況下,配額調高作業必須在專案層級進行。只有少數產品支援機構層級的配額調高調整。如要瞭解 Google Cloud 產品是否支援組織層級的配額增加調整,請參閱該產品的說明文件。

  • 您可以要求調專案、機構和資料夾層級的配額。

事前準備

本文中的工作需要 Identity and Access Management (IAM) 角色。

必要的角色

如要取得要求調整配額所需的權限,請要求管理員在專案、資料夾或組織中,授予您下列 IAM 角色:

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備申請調整配額所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

如要申請調整配額,您必須具備下列權限:

  • 如要要求調整配額,請按照下列步驟操作: serviceusage.quotas.update

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

在 Google Cloud 控制台中查看配額

您可以在Google Cloud 控制台的兩個不同專區中查看目前的配額值:

查看專案的配額

「IAM & Admin」(IAM 與管理) >「Quotas & System Limits」(配額與系統限制) 頁面會顯示表格,「服務」和「配額」欄會提供一般資訊,說明所描述的配額。舉例來說,「服務」可能是「Cloud Logging API」,「配額」可能是「每分鐘記錄檔擷取要求數」。「配額」Quota欄位也會說明配額的評估方式。頻率配額的評估單位為每分鐘、每 100 秒或每天。如果配額沒有上述任何陳述,就是分配配額。

如要查看專案中所有資源的配額用量和值,請按照下列步驟操作:

控制台

  1. 在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:

    前往「配額與系統限制」頁面

  2. 如要專心處理所需資訊,請按照下列步驟篩選及排序清單:

    • 如要篩選清單,請在欄位中輸入屬性和值。舉例來說,如要查看 BigQuery API 配額,請依序選取「Service」(服務) 和「BigQuery API」

    • 如要排序清單,請點選要排序的欄標題。舉例來說,如想依配額名稱的字母排序,請點選「Quota」(配額) 欄標題。

    根據預設,清單會依您最常用的配額排序,方便您查看有可能超過限制的配額。

  3. 選用步驟:如要檢查資料夾和組織層級的匯總配額用量,請在資源選取器中選取組織或資料夾。

您可以使用「指標」、「限制名稱」和「受監控的資源」欄,進一步瞭解配額。這些欄位提供繪製配額圖表所需的詳細資訊。

如要瞭解配額用量,請查看「目前用量百分比」和「目前用量」欄。系統會根據下列條件計算目前用量:

  • 每分鐘速率配額:

    • 過去 10 分鐘的每分鐘平均用量。
  • 每日重設的頻率配額:

    • 目前當天的用量 (以太平洋標準時間為準)。
  • 分配配額:

    • 最近期的值。舉例來說,這個數字可能顯示專案使用的負載平衡器數量。
  • 並行配額:

    • 最近期的值。舉例來說,這個數字可能顯示特定服務的飛行中 insert_operations 數量。

如要進一步瞭解特定服務的配額,請參閱該服務的說明文件。舉例來說,Compute Engine 配額記錄在「資源配額」一文中。

查看及匯出一段時間內的配額用量

您可以透過圖表查看一段時間內的配額用量。控制台的「配額與系統限制」頁面會提供「配額與系統限制」表格中,各項配額或系統限制的圖表。查看圖表後,您可以匯出圖表。 如要查看及匯出圖表,請按照下列步驟操作:

控制台

  1. 在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:

    前往「配額與系統限制」頁面

  2. 找出您感興趣的配額或系統限制。在配額或系統限制的項目中,按一下「顯示使用情況圖表」。圖表檢視畫面隨即開啟。

  3. 在圖表檢視畫面中設定時間範圍。預設值為 7 天。如要變更,請點選時間範圍選單,然後選取所需時間範圍。

  4. 如要匯出圖表,請依序點選「更多圖表選項」>「下載」「下載 PNG」。圖表會下載為 PNG 檔案。

如要進一步瞭解圖表功能,請參閱「設定配額快訊和監控」。

查看 API 專屬配額

如要查看特定 API 的詳細配額資訊 (包括用量變化),請前往 Google Cloud 主控台中的 API 配額頁面。視 API 而定,這類限制可能會包括「每日要求數」、「每分鐘要求數」和「每位使用者的每分鐘要求數」。有些 API 在您啟用專案的計費功能之前,會把限制設定得相當低。

如果特定配額沒有值,系統會顯示 Unlimited

您可以在 Google Cloud 控制台的兩個區塊中查看特定 API 的現行限制: Google Cloud 控制台的「配額與系統限制」頁面,或「API 和服務」頁面。使用偏好的控制台檢視畫面:

控制台

  • 如要使用篩選器,從「配額與系統限制」頁面查看 API 專屬配額,請按照下列步驟操作:

    1. 在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:

      前往「配額與系統限制」頁面

    2. 按一下「篩選」,然後從顯示的選單中選取「服務」

    3. 選取或輸入要查看的服務名稱。

      這個頁面會顯示指定 API 的配額和系統限制資訊。除非您調整配額,否則 Value 欄中顯示的數字都是預設配額值。

  • 如要從「APIs & Services」(API 和服務) 頁面查看 API 專屬配額,請按照下列步驟操作:

    1. 前往「APIs & Services」(API 和服務) 頁面:

      前往「API 與服務」頁面

    2. 選取專案。

    3. 按一下要查看的服務 API 名稱。

    4. 按一下「配額與系統限制」分頁標籤。

      這個頁面會顯示指定 API 的配額和系統限制資訊。除非您調整配額,否則 Value 欄中顯示的數字都是預設配額值。

如要查看一段時間內的用量,請按一下「顯示用量圖表」

篩選配額

如要依特定屬性篩選配額清單,請執行下列操作:

控制台

  1. 在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:

    前往「配額與系統限制」頁面

  2. 按一下「篩選」,即可按特定屬性名稱或值查詢配額。

使用控制台管理配額

您可以依據資源用量提高或降低專案的配額值。本節說明如何變更既有配額值。如要查看值,請按一下「詳細資料」欄中的「所有配額」

要求調整配額

Cloud Quotas 的調整要求可能需要經過審查。如果配額調整要求需要審查,我們會發送電子郵件通知,確認已收到您的要求。如需進一步協助,請回覆該電子郵件。要求經審查後,我們會傳送電子郵件,通知您要求是否獲准。您可以透過 Google Cloud 控制台、Cloud Quotas API 或 Google Cloud CLI 申請調整配額。以下說明如何使用 Google Cloud 控制台或向 Cloud Quotas API 發出 REST 要求,申請新的配額值。

控制台

如要申請調整配額,請按照下列步驟操作:

  1. 在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:

    前往「配額與系統限制」頁面

    如果系統提示選取專案,請選取要調整的專案。

  2. 找出要調整的配額,然後開啟「配額變更」對話方塊:

    • 表格未列出的配額:

      • 在「Filter」(篩選器) 搜尋框中搜尋配額。請勿指定區域或地帶 (如適用),因為配額如果沒有使用或調整值,就不會顯示在表格中。
      • 在表格中找出配額的任何項目。可以是預設項目,也可以是任何有記錄的項目,不論區域或時區。
      • 在項目所在資料列中,依序點選 「更多動作」>「設定其他區域/可用區」
      • 選取要調整的區域或時區。按一下 [編輯]
    • 所有其他配額:

      • 在「Filter」(篩選器) 搜尋框中搜尋配額。
      • 在項目的行中,選取配額的核取方塊。
      • 按一下「編輯」

    「Quota changes」(配額變更) 對話方塊隨即顯示。

  3. 如果「New value」(新值) 欄位上方顯示「Apply for higher quota」(申請更多配額) 連結,且您想將配額值提高到超出畫面上顯示的數字,請點選該連結。填寫表單並提交,其餘步驟可略過。否則請繼續按照本指南操作。

  4. 在「New value」(新值) 欄位中,輸入想要增加的配額值。如果出現「Request description」(要求說明) 欄位,請輸入說明。接著點選「完成」

    • 如果核取方塊顯示「我瞭解這項要求將移除任何覆寫設定」,表示您的配額值已設為低於預設值。將配額值調整為預設值或更高,會移除覆寫值。 如要繼續,請勾選核取方塊。進一步瞭解配額覆寫設定

    如果畫面上出現「Next」(下一步) 按鈕,請按一下「Next」(下一步),然後在隨後的畫面中填入聯絡資料。

  5. 點選「Submit request」(提交要求)

如果發現無法透過控制台提出調整要求,請向 Cloud Customer Care 申請提高配額。

如要進一步瞭解配額提高程序的運作方式,請參閱「關於配額調整」的相關說明。

批次傳送配額調整要求

您可以選取每個要納入的配額旁邊的核取方塊,以便批次傳送調整配額的要求。不過,批次傳送要求可能會增加 Google Cloud 審查要求所需的時間。

為縮短審查時間,請依產品和區域將配額調整要求分組。舉例來說,如果您想申請調整網路和 Compute Engine VM 配額,請分別建立網路配額和 Compute Engine VM 配額的要求。

REST

如要透過 Cloud Quotas API 申請調整配額,請使用下列程式碼範例。在可編輯的預留位置填入您的值。如要瞭解預留位置欄位,請參閱程式碼範例後方的說明。

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

更改下列內容:

  • PROJECT_NUMBER:您的 Google Cloud 專案編號。您可以在 Google Cloud 控制台的「Welcome」(歡迎)頁面找到專案編號,也可以執行下列 gcloud CLI 指令:

    PROJECT=$(gcloud info --format='value(config.project)')
    gcloud projects describe ${PROJECT} --format="value(projectNumber)"
  • QUOTA_PREFERENCE_ID:要更新的配額偏好設定 ID。

  • QUOTA_ID:要更新的配額 ID。

  • SERVICE_ID:要調整配額的 Google Cloud ID。通常採用 SERVICE_NAME.googleapis.com 格式。舉例來說,Compute Engine 服務名稱為 compute.googleapis.com

  • DIMENSION_1:要調整的維度類型,例如 regionzone。您可以加入多個維度。請在每個維度的值後面加上半形逗號,例如 VALUE_1,藉此分隔維度。如要調整配額的所有維度,請省略這一行。

  • VALUE_1:前一個維度的值。舉例來說,如果前一個維度是 region,請輸入區域,例如 us-central1

  • JUSTIFICATION:這項要求的原因。

  • EMAIL:如果 Google Cloud 需要更多資訊才能做出決定,並核發額外配額,這個電子郵件地址可用於聯絡。

要求範例

以下範例是針對 Compute Engine 配額 PUS-PER-GPU-FAMILY-per-project-region 提出配額值增加要求。這項要求會為 us-central1 地區的 GPU 系列 NVIDIA_H100 機器申請 100 的配額值。

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}

查看配額提高要求

您可以在Google Cloud 控制台中查看待處理和過去的配額提高要求。

如要查看待處理的配額提高要求,請按照下列步驟操作:

控制台

  1. 請確認您有權查看配額增加要求

  2. 在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:

    前往「配額與系統限制」頁面

  3. 如果先前提交的配額提高要求尚未核准,配額值旁會顯示「待處理」 圖示。按一下「待處理」,即可查看待處理要求的詳細資料。

即將提交配額調整要求時,「Quota changes」(配額變更) 表單也會顯示待處理的要求。

如要查看所有配額提高要求 (包括待處理和過去的要求),請按照下列步驟操作:

控制台

  1. 在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:

    前往「配額與系統限制」頁面

  2. 按一下「增加要求」分頁標籤。

  3. 按一下「篩選」,即可按特定屬性查詢配額提高要求。

選取機構或資料夾後,頁面會顯示機構或資料夾中所有專案的配額增加要求。

建立配額覆寫

如要限制特定資源的使用量,請建立配額覆寫,將配額值變更為小於預設配額值。建立配額覆寫有時也稱為「限制用量」

如要建立配額覆寫,請按照更新配額值一文中的步驟操作。

配額覆寫功能不適用於所有服務。如需服務專屬資訊,請參閱服務的配額和系統限制說明文件。

重設配額值

如要在套用覆寫後重設配額值,請按照下列步驟操作:

控制台

  1. 在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:

    前往「配額與系統限制」頁面

  2. 在「Filter」(篩選器) 搜尋框中輸入文字,即可搜尋配額。將「有覆寫」設為「True」,只顯示有覆寫的配額。

  3. 在「配額」頁面中,已覆寫的配額限制旁邊會顯示「覆寫」。按一下「覆寫」,即可查看這項配額的詳細資料,以及重設值的選項。

  4. 如要確認重設會移除覆寫設定,請按一下「重設值」前面的核取方塊,然後按一下「重設值」重設配額。

如要手動重設配額,請按照要求提高配額限制的步驟操作。請務必將「New value」(新值) 設為「Quota changes」(配額變更) 表單中配額名稱下方顯示的「Default value」(預設值)

使用 Cloud Quotas API 管理配額

您可以使用 Cloud Quotas API 取得目前的配額資訊,並為 Google Cloud API 和服務設定配額偏好設定。詳情請參閱下列文章:

使用 gcloud CLI 管理配額

如要使用 gcloud CLI,請務必安裝初始化最新版 gcloud CLI,包括 beta 指令元件。如果您使用 Cloud Shell 與 Google Cloud互動,系統會為您安裝 gcloud CLI。

詳情請參閱下列各節:

要求專案配額

如要進一步瞭解如何申請額外專案配額,請參閱「專案配額申請」支援文章。

後續步驟