本文說明如何在Google Cloud 控制台中查看配額值。您也可以透過Google Cloud 控制台、Cloud Quotas API 和 Google Cloud CLI (gcloud CLI) 管理配額。
限制
Cloud Quotas 具有下列限制:
在大多數情況下,配額調高作業必須在專案層級進行。只有少數產品支援機構層級的配額調高調整。如要瞭解 Google Cloud 產品是否支援組織層級的配額增加調整,請參閱該產品的說明文件。
您可以要求調降專案、機構和資料夾層級的配額。
事前準備
本文中的工作需要 Identity and Access Management (IAM) 角色。
必要的角色
如要取得要求調整配額所需的權限,請要求管理員在專案、資料夾或組織中,授予您下列 IAM 角色:
-
如要查看配額:
配額檢視者 (
roles/servicemanagement.quotaViewer) -
如要要求調整配額:
配額管理員 (
roles/servicemanagement.quotaAdmin)
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這些預先定義的角色具備申請調整配額所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
如要申請調整配額,您必須具備下列權限:
-
如要要求調整配額,請按照下列步驟操作:
serviceusage.quotas.update
在 Google Cloud 控制台中查看配額
您可以在Google Cloud 控制台的兩個不同專區中查看目前的配額值:
「配額與系統限制」頁面會列出專案的所有配額用量和值。
Google Cloud 主控台 API 資訊主頁會列出特定 API 的配額資訊,包括隨著時間變化的資源用量。
查看專案的配額
「IAM & Admin」(IAM 與管理) >「Quotas & System Limits」(配額與系統限制) 頁面會顯示表格,「服務」和「配額」欄會提供一般資訊,說明所描述的配額。舉例來說,「服務」可能是「Cloud Logging API」,「配額」可能是「每分鐘記錄檔擷取要求數」。「配額」Quota欄位也會說明配額的評估方式。頻率配額的評估單位為每分鐘、每 100 秒或每天。如果配額沒有上述任何陳述,就是分配配額。
如要查看專案中所有資源的配額用量和值,請按照下列步驟操作:
控制台
在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:
如要專心處理所需資訊,請按照下列步驟篩選及排序清單:
如要篩選清單,請在欄位中輸入屬性和值。舉例來說,如要查看 BigQuery API 配額,請依序選取「Service」(服務) 和「BigQuery API」。
如要排序清單,請點選要排序的欄標題。舉例來說,如想依配額名稱的字母排序,請點選「Quota」(配額) 欄標題。
根據預設,清單會依您最常用的配額排序,方便您查看有可能超過限制的配額。
選用步驟:如要檢查資料夾和組織層級的匯總配額用量,請在資源選取器中選取組織或資料夾。
您可以使用「指標」、「限制名稱」和「受監控的資源」欄,進一步瞭解配額。這些欄位提供繪製配額圖表所需的詳細資訊。
如要瞭解配額用量,請查看「目前用量百分比」和「目前用量」欄。系統會根據下列條件計算目前用量:
每分鐘速率配額:
- 過去 10 分鐘的每分鐘平均用量。
每日重設的頻率配額:
- 目前當天的總用量 (以太平洋標準時間為準)。
分配配額:
- 最近期的值。舉例來說,這個數字可能顯示專案使用的負載平衡器數量。
並行配額:
- 最近期的值。舉例來說,這個數字可能顯示特定服務的飛行中 insert_operations 數量。
如要進一步瞭解特定服務的配額,請參閱該服務的說明文件。舉例來說,Compute Engine 配額記錄在「資源配額」一文中。
查看及匯出一段時間內的配額用量
您可以透過圖表查看一段時間內的配額用量。控制台的「配額與系統限制」頁面會提供「配額與系統限制」表格中,各項配額或系統限制的圖表。查看圖表後,您可以匯出圖表。 如要查看及匯出圖表,請按照下列步驟操作:
控制台
在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:
找出您感興趣的配額或系統限制。在配額或系統限制的項目中,按一下「顯示使用情況圖表」。圖表檢視畫面隨即開啟。
在圖表檢視畫面中設定時間範圍。預設值為 7 天。如要變更,請點選時間範圍選單,然後選取所需時間範圍。
如要匯出圖表,請依序點選「更多圖表選項」>「下載」「下載 PNG」。圖表會下載為 PNG 檔案。
如要進一步瞭解圖表功能,請參閱「設定配額快訊和監控」。
查看 API 專屬配額
如要查看特定 API 的詳細配額資訊 (包括用量變化),請前往 Google Cloud 主控台中的 API 配額頁面。視 API 而定,這類限制可能會包括「每日要求數」、「每分鐘要求數」和「每位使用者的每分鐘要求數」。有些 API 在您啟用專案的計費功能之前,會把限制設定得相當低。
如果特定配額沒有值,系統會顯示 Unlimited。
您可以在 Google Cloud 控制台的兩個區塊中查看特定 API 的現行限制: Google Cloud 控制台的「配額與系統限制」頁面,或「API 和服務」頁面。使用偏好的控制台檢視畫面:
控制台
如要使用篩選器,從「配額與系統限制」頁面查看 API 專屬配額,請按照下列步驟操作:
在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:
按一下「篩選」,然後從顯示的選單中選取「服務」。
選取或輸入要查看的服務名稱。
這個頁面會顯示指定 API 的配額和系統限制資訊。除非您調整配額,否則
Value欄中顯示的數字都是預設配額值。
如要從「APIs & Services」(API 和服務) 頁面查看 API 專屬配額,請按照下列步驟操作:
前往「APIs & Services」(API 和服務) 頁面:
選取專案。
按一下要查看的服務 API 名稱。
按一下「配額與系統限制」分頁標籤。
這個頁面會顯示指定 API 的配額和系統限制資訊。除非您調整配額,否則
Value欄中顯示的數字都是預設配額值。
如要查看一段時間內的用量,請按一下「顯示用量圖表」。
篩選配額
如要依特定屬性篩選配額清單,請執行下列操作:
控制台
在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:
按一下「篩選」,即可按特定屬性名稱或值查詢配額。
使用控制台管理配額
您可以依據資源用量提高或降低專案的配額值。本節說明如何變更既有配額值。如要查看值,請按一下「詳細資料」欄中的「所有配額」。
要求調整配額
Cloud Quotas 的調整要求可能需要經過審查。如果配額調整要求需要審查,我們會發送電子郵件通知,確認已收到您的要求。如需進一步協助,請回覆該電子郵件。要求經審查後,我們會傳送電子郵件,通知您要求是否獲准。您可以透過 Google Cloud 控制台、Cloud Quotas API 或 Google Cloud CLI 申請調整配額。以下說明如何使用 Google Cloud 控制台或向 Cloud Quotas API 發出 REST 要求,申請新的配額值。
控制台
如要申請調整配額,請按照下列步驟操作:
在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:
如果系統提示選取專案,請選取要調整的專案。找出要調整的配額,然後開啟「配額變更」對話方塊:
表格未列出的配額:
- 在「Filter」(篩選器) 搜尋框中搜尋配額。請勿指定區域或地帶 (如適用),因為配額如果沒有使用或調整值,就不會顯示在表格中。
- 在表格中找出配額的任何項目。可以是預設項目,也可以是任何有記錄的項目,不論區域或時區。
- 在項目所在資料列中,依序點選 「更多動作」>「設定其他區域/可用區」。
- 選取要調整的區域或時區。按一下 [編輯]。
所有其他配額:
- 在「Filter」(篩選器) 搜尋框中搜尋配額。
- 在項目的行中,選取配額的核取方塊。
- 按一下「編輯」。
「Quota changes」(配額變更) 對話方塊隨即顯示。
如果「New value」(新值) 欄位上方顯示「Apply for higher quota」(申請更多配額) 連結,且您想將配額值提高到超出畫面上顯示的數字,請點選該連結。填寫表單並提交,其餘步驟可略過。否則請繼續按照本指南操作。
在「New value」(新值) 欄位中,輸入想要增加的配額值。如果出現「Request description」(要求說明) 欄位,請輸入說明。接著點選「完成」。
- 如果核取方塊顯示「我瞭解這項要求將移除任何覆寫設定」,表示您的配額值已設為低於預設值。將配額值調整為預設值或更高,會移除覆寫值。 如要繼續,請勾選核取方塊。進一步瞭解配額覆寫設定。
如果畫面上出現「Next」(下一步) 按鈕,請按一下「Next」(下一步),然後在隨後的畫面中填入聯絡資料。
點選「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:要調整的維度類型,例如region或zone。您可以加入多個維度。請在每個維度的值後面加上半形逗號,例如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 控制台中查看待處理和過去的配額提高要求。
如要查看待處理的配額提高要求,請按照下列步驟操作:
控制台
請確認您有權查看配額增加要求。
在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:
如果先前提交的配額提高要求尚未核准,配額值旁會顯示「待處理」 圖示。按一下「待處理」,即可查看待處理要求的詳細資料。
即將提交配額調整要求時,「Quota changes」(配額變更) 表單也會顯示待處理的要求。
如要查看所有配額提高要求 (包括待處理和過去的要求),請按照下列步驟操作:
控制台
在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:
按一下「增加要求」分頁標籤。
按一下「篩選」,即可按特定屬性查詢配額提高要求。
選取機構或資料夾後,頁面會顯示機構或資料夾中所有專案的配額增加要求。
建立配額覆寫
如要限制特定資源的使用量,請建立配額覆寫,將配額值變更為小於預設配額值。建立配額覆寫有時也稱為「限制用量」。
如要建立配額覆寫,請按照更新配額值一文中的步驟操作。
配額覆寫功能不適用於所有服務。如需服務專屬資訊,請參閱服務的配額和系統限制說明文件。
重設配額值
如要在套用覆寫後重設配額值,請按照下列步驟操作:
控制台
在 Google Cloud 控制台,依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面:
在「Filter」(篩選器) 搜尋框中輸入文字,即可搜尋配額。將「有覆寫」設為「True」,只顯示有覆寫的配額。
在「配額」頁面中,已覆寫的配額限制旁邊會顯示「覆寫」。按一下「覆寫」,即可查看這項配額的詳細資料,以及重設值的選項。
如要確認重設會移除覆寫設定,請按一下「重設值」前面的核取方塊,然後按一下「重設值」重設配額。
如要手動重設配額,請按照要求提高配額限制的步驟操作。請務必將「New value」(新值) 設為「Quota changes」(配額變更) 表單中配額名稱下方顯示的「Default value」(預設值)。
使用 Cloud Quotas API 管理配額
您可以使用 Cloud Quotas API 取得目前的配額資訊,並為 Google Cloud API 和服務設定配額偏好設定。詳情請參閱下列文章:
- 如需總覽,請參閱「Cloud Quotas API 總覽」。
- 如需瞭解如何設定開發環境,請參閱「設定 Cloud Quotas API」。
- 如需範例,瞭解如何使用 Cloud Quotas API 調整配額,以及在 Google Cloud 專案、資料夾或機構中自動調整配額,請參閱「實作常見用途」。
使用 gcloud CLI 管理配額
如要使用 gcloud CLI,請務必安裝並初始化最新版 gcloud CLI,包括 beta 指令元件。如果您使用 Cloud Shell 與 Google Cloud互動,系統會為您安裝 gcloud CLI。
詳情請參閱下列各節:
如需
gcloud beta quotas info和gcloud beta quotas preferences指令的範例,請參閱「使用 gcloud CLI 查看及管理配額」。如需
gcloud beta quotas指令和標記的完整清單,請參閱 Google Cloud CLI 參考資料的「gcloud beta quotas」一節。
要求專案配額
如要進一步瞭解如何申請額外專案配額,請參閱「專案配額申請」支援文章。
後續步驟
- 設定配額調整工具,讓系統監控並代您提交配額調整要求。
- 使用 Cloud Quotas API 在專案層級管理配額。
- 使用 IAM 或 VPC Service Controls 控制存取權。
- 設定配額專案。
- 監控及排解配額問題。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2026-01-27 (世界標準時間)。