gcloud alpha CLI を使用して割り当てを表示する

以降のセクションでは、gcloud alpha quotas info コマンドと gcloud alpha quotas preferences コマンドの例を示します。これらのコマンドを使用すると、QuotaInfo リソースと QuotaPreference リソースを表示して管理できます。

Google Cloud CLI（gcloud CLI）を使用すると、現在の割り当て値を取得し、一部の Google Cloud APIs とサービスの割り当て設定を指定できます。

制限事項

Cloud Quotas には次の制限があります。

割り当ての増加調整はすべて Google Cloud の承認が必要となります。
プロジェクトレベルの割り当てに対して、割り当ての増減の両方をリクエストできます。
割り当ての減少調整は、プロジェクト、フォルダ、組織レベルの割り当てに対してリクエストできます。

始める前に

始める前に、gcloud CLI をインストールして初期化してください。

QUOTA_ID 値が必要になることもあります。その場合は、QUOTA_ID を見つける手順をご覧ください。

gcloud CLI をインストールして初期化する

gcloud CLI を使用するには、アルファ版のコマンドコンポーネントを含む最新バージョンの gcloud CLI をインストールして、初期化する必要があります。Cloud Shell を使用して Google Cloud を操作している場合は、gcloud CLI がインストールされています。

割り当て ID を確認する

このページの gcloud CLI コマンドの多くは、割り当て ID の値を参照します。

割り当て ID の値を確認するには、次の gcloud CLI コマンドを使用して、指定したサービスの割り当て情報を一覧表示します。

ターミナルウィンドウに次の gcloud CLI コマンドを入力します。
```
gcloud alpha quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER
```
次のように置き換えます。
- SERVICE_NAME: 表示する割り当てを含むサービス名。たとえば、Cloud Logging のサービス名は logging.googleapis.com です。
- PROJECT_ID_OR_NUMBER: プロジェクト ID またはプロジェクト番号
  
  Google Cloud コンソールを使用してプロジェクト ID を確認するには、[Resource Manager] ページに移動します。
  
  Resource Manager に移動

gcloud alpha 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 alpha quotas info コマンドを使用して特定のサービスまたは組織の割り当て情報を表示する方法の例を示します。

QuotaInfo は、特定のプロジェクト、フォルダ、または組織の特定の割り当てに関するメタデータと割り当て値の情報を提供する読み取り専用のリソースです。

特定のサービスの割り当て情報を表示する

特定のサービスの割り当て情報を表示するには、次のコマンドを実行します。

gcloud alpha quotas info describe QUOTA_ID --service=SERVICE_NAME \
    --project=PROJECT_ID_OR_NUMBER

次のように置き換えます。

QUOTA_ID: 割り当ての ID
SERVICE_NAME: 表示する割り当てを含むサービス名。たとえば、Cloud Logging のサービス名は logging.googleapis.com です。
PROJECT_ID_OR_NUMBER: プロジェクト ID またはプロジェクト番号

組織の割り当て情報を表示する

組織の同じサービスの割り当ての詳細を表示するには、次のコマンドを実行します。

gcloud alpha quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID

次のように置き換えます。

SERVICE_NAME: 表示する割り当てを含むサービス名。たとえば、Cloud Logging のサービス名は logging.googleapis.com です。
ORGANIZATION_ID: 組織の ID

gcloud 割り当て設定コマンドの例

このセクションでは、gcloud alpha quotas preferences コマンドを使用して既存の割り当て設定を確認し、割り当て値を調整する方法の例を示します。

QuotaPreference リソースは、特定のディメンションの組み合わせに対する設定を表します。ディメンションは、リージョンやゾーンを表す属性、またはサービス固有のディメンション（gpu_family や network_id など）です。

既存の設定を確認する

既存の設定を確認するには、次のコマンドを実行します。

gcloud alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER

PROJECT_ID_OR_NUMBER は、プロジェクト ID またはプロジェクト番号に置き換えます。

保留中の割り当て調整で既存の設定を確認する

保留中の割り当て調整で既存の設定を確認するには、次のコマンドのように --reconciling-only=true フラグを追加します。

gcloud alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER --reconciling-only=true

PROJECT_ID_OR_NUMBER は、プロジェクト ID またはプロジェクト番号に置き換えます。

割り当て設定がない場合に、特定のリージョンの割り当ての増加をリクエストする

まだ設定されていない場合に特定のリージョンの割り当て増加をリクエストするには、次のコマンドを実行します。

gcloud alpha quotas preferences create --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME \
    --project=PROJECT_ID_OR_NUMBER --preference-id=PREFERENCE_ID

次のように置き換えます。

PREFERRED_VALUE: 優先割り当て値
QUOTA_ID: 割り当ての ID
SERVICE_NAME: 表示する割り当てを含むサービス名。たとえば、Cloud Logging のサービス名は logging.googleapis.com です。
PROJECT_ID_OR_NUMBER: プロジェクト ID またはプロジェクト番号
PREFERENCE_ID: 設定 ID

割り当て設定がない場合に、特定のリージョンの割り当ての増加調整をリクエストする

特定のリージョンの割り当て引き上げをリクエストし、すでに設定がある場合は、次のコマンドを再実行します。

gcloud alpha quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME--project=PROJECT_ID_OR_NUMBER

次のように置き換えます。

PREFERENCE_ID: 設定 ID
PREFERRED_VALUE</var>"}}: 優先割り当て値
QUOTA_ID: 割り当ての ID
SERVICE_NAME: 表示する割り当てを含むサービス名。たとえば、Cloud Logging のサービス名は logging.googleapis.com です。
PROJECT_ID_OR_NUMBER: プロジェクト ID またはプロジェクト番号

既存の割り当て設定を取得する

既存の割り当て設定を取得するには、次のコマンドを実行します。

gcloud alpha quotas preferences describe PREFERENCE_ID project=PROJECT_ID_OR_NUMBER

次のように置き換えます。

PREFERENCE_ID: 設定 ID
PROJECT_ID_OR_NUMBER: プロジェクト ID またはプロジェクト番号

割り当てに関連する gcloud CLI コマンドを含むその他のサービス

さらに、一部のサービスでは、gcloud alpha quotas のみでなく、割り当てとリソース使用量に関する情報に独自のコマンドラインからアクセスすることもできます。

たとえば、Compute Engine では、割り当て情報にアクセスできます。詳細については、Compute Engine の次のセクションをご覧ください。

数量に基づく割り当て
gcloud CLI compute の概要
Google Cloud SDK リファレンスの gcloud CLI compute セクション。

次のステップ

gcloud alpha quotas コマンドとフラグの完全なリストについては、Google Cloud CLI リファレンスの gcloud alpha quotas をご覧ください。

割り当ての用語の詳細については、割り当ての値とシステムの上限についてをご覧ください。