本頁面的部分或全部資訊可能不適用於 Cloud de Confiance by S3NS。詳情請參閱「與 Google Cloud 的差異」。

本頁面由 Cloud Translation API 翻譯而成。

使用 gcloud beta CLI 管理配額

下列各節包含 gcloud beta quotas info 和 gcloud beta quotas preferences 指令範例。您可以使用這些指令查看及管理 QuotaInfo 和 QuotaPreference 資源。

您可以使用 Google Cloud CLI (gcloud CLI) 取得目前的配額值，並為部分 Cloud de Confiance by S3NS API 和服務指定配額偏好設定。

限制

Cloud Quotas 具有下列限制：

在大多數情況下，配額調高作業必須在專案層級進行。只有少數產品支援機構層級的配額調高調整。如要確認 Cloud de Confiance by S3NS 產品是否支援組織層級的配額提高調整，請參閱該產品的說明文件。
您可以要求調降專案、機構和資料夾層級的配額。

事前準備

使用 gcloud CLI 前，請務必安裝並初始化 gcloud CLI。

您可能也需要 QUOTA_ID 值。如果是，請參閱配額 ID 查詢說明。

安裝並初始化 gcloud CLI

如要使用 gcloud CLI 存取 Cloud Quotas，請務必安裝及初始化元件：

安裝 gcloud CLI。

如果您使用 Cloud Shell，可以略過這個步驟，因為 gcloud CLI 已預先安裝。
初始化 gcloud CLI。
安裝 Beta 版元件執行下列指令：
```
gcloud components install beta
```

找出配額 ID

本文中的多個 gcloud CLI 指令會參照配額 ID 值。您可以使用 Cloud de Confiance 控制台、gcloud CLI、用戶端程式庫或 REST API 找出配額 ID。本節說明如何使用 Cloud de Confiance 控制台或 gcloud CLI 找出配額 ID。

控制台

在 Cloud de Confiance 控制台，依序前往「IAM & Admin」(IAM 與管理) >「Quotas & System Limits」(配額與系統限制) 頁面：
前往「配額與系統限制」
按一下「篩選器」，即可篩選服務。
如果沒有看到「限制名稱」欄，請按一下「資料欄顯示選項...」圖示。選取「限制名稱」，然後按一下「確定」。
「限制名稱」欄會顯示配額 ID。

gcloud

如要使用 gcloud CLI 找出配額 ID 值，請執行下列指令，列出指定服務的配額資訊：

在終端機視窗中輸入下列 gcloud CLI 指令：
```
gcloud beta quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER
```
更改下列內容：
- SERVICE_NAME：您要查看配額的服務名稱，例如 Compute Engine 的服務名稱為 compute.googleapis.com。
- PROJECT_ID_OR_NUMBER：專案 ID 或專案編號。
  
  如要使用 Cloud de Confiance 控制台找出專案 ID，請前往 Resource Manager 頁面：
  前往 Resource Manager
- BILLING_PROJECT_ID_OR_NUMBER：專案的 ID 或專案編號，您要使用該專案的 Cloud Quotas API 配額執行這項指令。這可能與您要尋找配額 ID 的服務所屬專案不同。
  
  如果您在設定 gcloud CLI 時已設定帳單專案，則此標記為選用。否則，省略這項設定可能會導致權限遭拒錯誤。詳情請參閱「設定配額專案」。

gcloud beta quotas info list 指令的輸出內容包含類似下列範例的文字：

...
"quotaInfos": [
    ...
    {
        "name": "projects/PROJECT_NUMBER/locations/global/services/compute.googleapis.com/quotaInfos/CPUS-per-project-region",
        "quotaId": "CPUS-per-project-region",
        "metric": "compute.googleapis.com/cpus",
        "containerType": "PROJECT",
        "dimensions": [
            "region"
        ],
        "dimensionsInfo": [
            {
                "details": {
                    "value": 20
                },
                "applicableLocations": [
                    "us-central1",
                    "us-central2",
                    "us-west1",
                    "us-east1"
                ]
                ...
            }
        ]
    },
    ...
]
...

找出與 quotaId 對應的值，並在後續章節中指定 QUOTA_ID 時使用。

gcloud 配額資訊指令範例

本節提供範例，說明如何使用 gcloud beta quotas info 指令查看特定服務或機構的配額資訊。

QuotaInfo 是唯讀資源，可提供特定專案、資料夾或機構的特定配額相關中繼資料和配額值資訊。

查看特定服務的配額資訊

如要查看特定服務的配額資訊，請執行下列指令：

gcloud beta quotas info describe QUOTA_ID --service=SERVICE_NAME \
    --project=PROJECT_ID_OR_NUMBER --billing-project=BILLING_PROJECT_ID_OR_NUMBER

更改下列內容：

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 時已設定帳單專案，則此標記為選用。否則，省略這項設定可能會導致權限遭拒錯誤。詳情請參閱「設定配額專案」。

查看機構的配額資訊

如要查看相同服務的機構配額詳細資料，請執行下列指令：

gcloud beta quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

更改下列內容：

SERVICE_NAME：您要查看配額的服務名稱，例如 Compute Engine 的服務名稱為 compute.googleapis.com。
ORGANIZATION_ID：貴機構的 ID。
BILLING_PROJECT_ID_OR_NUMBER：專案的 ID 或專案編號，您要使用該專案的 Cloud Quotas API 配額執行這項指令。這可能與您要查看配額資訊的服務所屬專案不同。

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

gcloud 偏好設定配額指令範例

本節提供範例，說明如何使用 gcloud beta quotas preferences 指令檢查現有配額偏好設定，以及調整配額值。

QuotaPreference 資源代表您對特定維度組合的偏好設定。維度是代表區域或可用區的屬性，或是服務專屬維度，例如 gpu_family 或 network_id。

檢查現有偏好設定

如要檢查現有偏好設定，請執行下列指令：

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

更改下列內容：

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

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

檢查是否有待處理配額調整的現有偏好設定

如要檢查是否有待處理的配額調整要求，請加入 --reconciling-only=true 旗標，如下列指令所示：

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：可做為聯絡方式的電子郵件地址，以防 Cloud de Confiance by S3NS 需要更多資訊才能核准額外配額。
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：可做為聯絡方式的電子郵件地址。如果 Cloud de Confiance by S3NS 需要更多資訊才能授予額外配額，我們會透過這個地址與您聯絡。
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'

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

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

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

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

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

gcloud services enable cloudquotas.googleapis.com

在用戶端專案中建立服務帳戶：
```
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。
建立服務帳戶金鑰：
```
gcloud iam service-accounts keys create KEY_FILE \
  --iam-account=SA_NAME@CLIENT_PROJECT_ID.s3ns.iam.gserviceaccount.com
```
更改下列內容：
- KEY_FILE：JSON 服務帳戶金鑰檔案的路徑。
- SA_NAME@CLIENT_PROJECT_ID.s3ns.iam.gserviceaccount.com：服務帳戶電子郵件地址。

將 IAM 權限授予服務帳戶：

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

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

更改下列內容：

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

使用您先前建立的服務帳戶金鑰，啟用服務帳戶：
```
gcloud auth activate-service-account --key-file=KEY_FILE
```
指定專案和啟用設定，在資源專案中啟用配額調整工具：
```
gcloud beta quotas adjuster settings update --project=RESOURCE_PROJECT_ID \
  --enablement=enabled
```
使用 gcloud CLI 時必須啟用這項設定，且必須設為 enabled 或 disabled。

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

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 一節。
如要進一步瞭解配額術語，請參閱「瞭解配額和系統限制術語」。