使用 gcloud beta CLI 管理配額

gcloud beta quotas preferences list --project=PROJECT_ID_OR_NUMBER --reconciling-only=true \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

更改下列內容：

• PROJECT_ID_OR_NUMBER：專案 ID 或專案編號。

• BILLING_PROJECT_ID_OR_NUMBER：專案的 ID 或專案編號，您要使用該專案的 Cloud Quotas API 配額執行這項指令。這與您要檢查配額偏好的服務所屬專案不同。

  如果您在設定 gcloud CLI 時已設定帳單專案，則此標記為選用。否則，省略這項設定可能會導致權限遭拒錯誤。詳情請參閱「設定配額專案」。

如果尚未設定配額偏好設定，請申請調整配額

如要使用 gcloud CLI 申請調整配額，請執行下列指令：

gcloud beta quotas preferences create --project=PROJECT_ID_OR_NUMBER \
    --service=SERVICE_NAME \
    --quota-id=QUOTA_ID \
    --dimensions=DIMENSIONS \
    --preferred-value=PREFERRED_VALUE \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER \
    --email=EMAIL \
    --justification=JUSTIFICATION \
    --preference-id=PREFERENCE_ID

更改下列內容：

• PROJECT_ID_OR_NUMBER：專案 ID 或專案編號。
• SERVICE_NAME：要調整配額的服務名稱，例如 Compute Engine 的服務名稱為 compute.googleapis.com。
• QUOTA_ID：配額 ID 值。 如要找出這個值，請參閱「找出配額 ID」。
• DIMENSIONS：要調整的維度，指定為以逗號分隔的鍵/值組合清單，例如 region=us-east4,gpu_family=NVIDIA_H100。 如要進一步瞭解配額維度，請參閱「設定 Cloud Quotas 維度」。
• PREFERRED_VALUE：偏好的配額值。
• BILLING_PROJECT_ID_OR_NUMBER：專案的 ID 或專案編號，您想使用該專案的 Cloud Quotas API 配額執行這項指令。這與您要求調整配額的服務所屬專案不同。

  如果您在設定 gcloud CLI 時已設定帳單專案，則此標記為選用。否則，省略這項設定可能會導致權限遭拒錯誤。詳情請參閱「設定配額專案」。

• EMAIL：可做為聯絡方式的電子郵件地址，以防 Google Cloud 需要更多資訊才能核准額外配額。
• JUSTIFICATION：說明要求的選用字串。
• PREFERENCE_ID：偏好設定 ID (選用)。如未指定偏好設定 ID，API 會為您產生通用唯一識別碼 (UUID)。

輸出看起來類似以下內容：

{
    "createTime":"CREATE_TIME",
    "dimensions":{
        "DIMENSION_KEY_1":"DIMENSION_VALUE_1",
        "DIMENSION_KEY_2":"DIMENSION_VALUE_2"
    },
    "etag":"ETAG_VALUE",
    "name":"projects/PROJECT_ID_OR_NUMBER/locations/global/quotaPreferences/PREFERENCE_ID",
    "quotaConfig":{
        "grantedValue":"GRANTED_VALUE",
        "preferredValue":"PREFERRED_VALUE",
        "traceId":"TRACE_ID"
    },
    "quotaId":"QUOTA_ID",
    "reconciling":true,
    "service":"SERVICE_NAME",
    "updateTime":"UPDATE_TIME",
}

設定配額偏好後，申請調整配額

如要為特定區域申請調整配額，且已有偏好設定，請執行下列指令：

gcloud beta quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL  \
    --justification=JUSTIFICATION

更改下列內容：

• PREFERENCE_ID：偏好設定 ID，使用 gcloud beta quotas preferences update 指令時，這是必要的第一個引數。
• PREFERRED_VALUE：偏好的配額值。
• QUOTA_ID：配額 ID 值。 如要找出這個值，請參閱「找出配額 ID」。
• SERVICE_NAME：您要查看配額的服務名稱，例如 Compute Engine 的服務名稱為 compute.googleapis.com。
• PROJECT_ID_OR_NUMBER：專案 ID 或專案編號。

• BILLING_PROJECT_ID_OR_NUMBER：專案的 ID 或專案編號，您要使用該專案的 Cloud Quotas API 配額執行這項指令。這可能與您要申請調整配額的服務所屬專案不同。

  如果您在設定 gcloud CLI 時已設定帳單專案，則此標記為選用。否則，省略這項設定可能會導致權限遭拒錯誤。詳情請參閱「設定配額專案」。

• EMAIL：可做為聯絡方式的電子郵件地址。如果 Google Cloud 需要更多資訊才能授予額外配額，我們會透過這個地址與您聯絡。

• JUSTIFICATION：說明要求的選用字串。

查看現有的配額偏好設定

如要查看您剛才建立的配額偏好設定詳細資料，請執行下列指令：

gcloud beta quotas preferences describe PREFERENCE_ID \
    --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

更改下列內容：

• PREFERENCE_ID：偏好設定 ID，使用 gcloud beta quotas preferences describe 指令時，這是必要的第一個引數。
• PROJECT_ID_OR_NUMBER：專案 ID 或專案編號。

• BILLING_PROJECT_ID_OR_NUMBER：專案的 ID 或專案編號，您要使用該專案的 Cloud Quotas API 配額執行這項指令。這可能與您要查看配額偏好的服務所屬專案不同。

  如果您在設定 gcloud CLI 時已設定帳單專案，則此標記為選用。否則，省略這項設定可能會導致權限遭拒錯誤。詳情請參閱「設定配額專案」。

輸出內容會包含特定於您設定的資料，且與下列範例輸出內容類似：

createTime: 'CREATE_TIME'
dimensions:
  gpu_family: NVIDIA_H100
  region: us-east4
etag: ETAG_VALUE
name: projects/12345/locations/global/quotaPreferences/PREFERENCE_ID
quotaConfig:
  grantedValue: '0'
  preferredValue: '128'
  traceId: TRACE_ID
quotaId: GPUS-PER-GPU-FAMILY-per-project-region
reconciling: true
service: compute.googleapis.com
updateTime: 'UPDATE_TIME'

透過用戶端專案啟用配額調整工具

用戶端專案是指應用程式或使用者用來存取及與資源互動的專案 Google Cloud ，而資源專案則是儲存及管理這些資源的基礎專案。

如要透過用戶端專案使用 gcloud CLI 啟用配額調整工具，請按照下列步驟操作：

1. 建立客戶專案：

   gcloud projects create CLIENT_PROJECT_ID
   gcloud config set project CLIENT_PROJECT_ID
   

   將 CLIENT_PROJECT_ID 替換為要建立的專案 ID。專案 ID 無法變更，只能在建立專案時設定。開頭必須是小寫字母，並可包含小寫 ASCII 字母、數字或連字號，專案 ID 長度必須介於 6 至 30 個字元之間。

2. 在用戶端專案中啟用 Cloud Quotas API：

   gcloud services enable cloudquotas.googleapis.com
   

3. 在用戶端專案中建立服務帳戶：

   gcloud iam service-accounts create SA_NAME \
     --display-name SA_DISPLAY_NAME \
     --project=CLIENT_PROJECT_ID
   

   更改下列內容：

   • SA_NAME：新服務帳戶的內部名稱。 用於產生 IAM_ACCOUNT (做為服務帳戶 ID 的 IAM 內部電子郵件地址)，必須傳遞至後續指令。
   • SA_DISPLAY_NAME：服務帳戶的顯示名稱。
   • CLIENT_PROJECT_ID：用戶端專案的 ID。

4. 建立服務帳戶金鑰：

   gcloud iam service-accounts keys create KEY_FILE \
     --iam-account=SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com
   

   更改下列內容：

   • KEY_FILE：JSON 服務帳戶金鑰檔案的路徑。
   • SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com： 服務帳戶電子郵件地址。

5. 將 IAM 權限授予服務帳戶：

   gcloud projects add-iam-policy-binding CLIENT_PROJECT_ID \
     --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/serviceusage.serviceUsageConsumer"
   
   gcloud projects add-iam-policy-binding RESOURCE_PROJECT_ID \
     --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/cloudquotas.admin"
   

   更改下列內容：

   • CLIENT_PROJECT_ID：用戶端專案的 ID。
   • RESOURCE_PROJECT_ID：資源專案的 ID。
   • SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com： 服務帳戶電子郵件地址。

6. 使用您先前建立的服務帳戶金鑰，啟用服務帳戶：

   gcloud auth activate-service-account --key-file=KEY_FILE
   

7. 指定專案和啟用設定，在資源專案中啟用配額調整工具：

   gcloud beta quotas adjuster settings update --project=RESOURCE_PROJECT_ID \
     --enablement=enabled
   

   使用 gcloud CLI 時必須啟用這項設定，且必須設為 enabled 或 disabled。

8. 選用：如要查看目前的配額調整工具設定，請執行下列指令：

   gcloud beta quotas adjuster settings describe --project=RESOURCE_PROJECT_ID 
   

   輸出結果會與下列範例相似：

   enablement: ENABLED
   etag: 8izmJp6EI__mOfLyhkQU9
   name: projects/RESOURCE_PROJECT_ID/locations/global/quotaAdjusterSettings
   updateTime: '2025-01-10T17:22:37.883221181Z'
   

如要為多個用戶端專案啟用配額調整工具，請按照先前的步驟 5 到 8 操作。執行這項操作時，請務必符合下列條件：

• 用戶端專案已啟用 Cloud Quotas API。
• 服務帳戶在所有要啟用配額調整器的資源專案中，都具有 cloudquotas.admin IAM 角色。

其他提供配額相關 gcloud CLI 指令的服務

除了 gcloud beta quotas 之外，部分服務也能讓您使用指令列查看配額和資源用量資訊。

舉例來說，Compute Engine 可讓您存取配額資訊。詳情請參閱下列 Compute Engine 專區：

• 分配配額
• gcloud CLI Compute 總覽
• Google Cloud SDK 參考資料的 gcloud CLI compute 部分

後續步驟

• 如要排解 gcloud beta quotas 指令的問題，請參閱「排解 gcloud CLI 錯誤」。

• 如要進一步瞭解 gcloud beta quotas 指令和標記，請參閱 Google Cloud CLI 參考資料的 gcloud beta quotas 一節。

• 如要進一步瞭解配額術語，請參閱「瞭解配額和系統限制術語」。