Kontingente mit der gcloud beta CLI verwalten

Die folgenden Abschnitte enthalten gcloud beta quotas info- und gcloud beta quotas preferences-Beispielbefehle. Mit diesen Befehlen können Sie die Ressourcen QuotaInfo und QuotaPreference aufrufen und verwalten.

Mit der Google Cloud CLI (gcloud CLI) können Sie aktuelle Kontingentwerte abrufen und Kontingenteinstellungen für einige Google Cloud APIs und -Dienste angeben.

Beschränkungen

Für Cloud-Kontingente gelten die folgenden Einschränkungen:

  • In den meisten Fällen müssen Anpassungen der Kontingenterhöhung auf Projektebene vorgenommen werden. Für eine begrenzte Anzahl von Produkten werden Anpassungen zur Kontingenterhöhung auf Organisationsebene unterstützt. Ob ein Google Cloud -Produkt Anpassungen von Kontingenterhöhungen auf Organisationsebene unterstützt, erfahren Sie in der Dokumentation für dieses Produkt.

  • Sie können eine Verringerung der Kontingente für Kontingente auf Projekt-, Organisations- und Ordner-Ebene anfordern.

Hinweise

Bevor Sie die gcloud CLI verwenden, müssen Sie die gcloud CLI installieren und initialisieren.

Möglicherweise benötigen Sie auch den Wert QUOTA_ID. In diesem Fall folgen Sie der Anleitung zum Ermitteln Ihrer Kontingent-ID.

gcloud CLI installieren und initialisieren

Wenn Sie die gcloud CLI für Cloud-Kontingente verwenden möchten, müssen Sie Komponenten installieren und initialisieren:

  1. Installieren Sie die gcloud CLI.

    Wenn Sie Cloud Shell verwenden, können Sie diesen Schritt überspringen, da die gcloud CLI vorinstalliert ist.

  2. Initialisieren Sie die gcloud CLI.

  3. Installieren Sie die Betakomponente mit dem folgenden Befehl:

    gcloud components install beta
    

Kontingent-ID ermitteln

Mehrere gcloud CLI-Befehle auf dieser Seite beziehen sich auf Ihren Kontingent-ID-Wert. Sie können die Kontingent-ID über die Google Cloud -Konsole, die gcloud CLI, Clientbibliotheken oder die REST API abrufen. In diesem Abschnitt erfahren Sie, wie Sie die Kontingent-ID über die Google Cloud Console oder die gcloud CLI finden.

Console

  1. Gehen Sie in der Google Cloud Console zu IAM und Verwaltung > Kontingente und Systemlimits:

    Zur Seite „Kontingente und Systemlimits“

  2. Klicken Sie auf Filtern, um nach Ihrem Dienst zu filtern.

  3. Wenn die Spalte Limitname nicht angezeigt wird, klicken Sie auf das Symbol  Spaltenanzeigeoptionen. Wählen Sie Limitname aus und klicken Sie auf OK.

  4. In der Spalte Limitname wird die Kontingent-ID angezeigt.

gcloud

Wenn Sie den Kontingent-ID-Wert mit der gcloud CLI ermitteln möchten, führen Sie den folgenden Befehl aus, um Ihre Kontingentinformationen für den angegebenen Dienst aufzulisten:

  1. Geben Sie den folgenden gcloud CLI-Befehl in einem Terminalfenster ein:

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

    Ersetzen Sie Folgendes:

    • SERVICE_NAME: Der Dienstname mit den Kontingenten, die Sie sehen möchten. Der Dienstname für Compute Engine ist beispielsweise compute.googleapis.com.

    • PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer

      Wenn Sie Ihre Projekt-ID über die Google Cloud Console ermitteln möchten, rufen Sie die Seite „Resource Manager“ auf:

      Zum Ressourcenmanager

    • BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer für Kontingente und die Abrechnung. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als ob Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt hätten.

      Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Das kann sich von dem Projekt unterscheiden, das den Dienst enthält, für den Sie die Kontingent-ID suchen.

      Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann das Weglassen zu einem Fehler vom Typ „Berechtigung verweigert“ führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.

  2. Die Ausgabe des Befehls gcloud beta quotas info list enthält Text, der dem folgenden Beispiel ähnelt:

    ...
    "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"
                    ]
                    ...
                }
            ]
        },
        ...
    ]
    ...
  3. Suchen Sie nach dem Wert, der quotaId entspricht, und verwenden Sie ihn, wenn Sie QUOTA_ID in den folgenden Abschnitten angeben.

Beispiele für gcloud-Kontingentinformationsbefehle

Dieser Abschnitt enthält Beispiele, die zeigen, wie gcloud beta quotas info-Befehle zum Anzeigen von Kontingentinformationen für einen bestimmten Dienst oder für eine Organisation verwendet werden.

QuotaInfo ist eine schreibgeschützte Ressource, die Informationen zu Metadaten und Kontingentwerten zu einem bestimmten Kontingent für ein bestimmtes Projekt, einen Ordner oder eine Organisation bereitstellt.

Kontingentinformationen für einen bestimmten Dienst ansehen

Führen Sie den folgenden Befehl aus, um Kontingentinformationen für einen bestimmten Dienst aufzurufen:

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

Ersetzen Sie Folgendes:

  • QUOTA_ID: der ID-Wert des Kontingents. Informationen zum Ermitteln dieses Werts finden Sie unter Kontingent-ID finden.
  • SERVICE_NAME: Der Dienstname mit den Kontingenten, die Sie sehen möchten. Der Dienstname für Compute Engine ist beispielsweise compute.googleapis.com.
  • PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer
  • BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer für Kontingente und die Abrechnung. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als ob Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt hätten.

    Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Das kann sich von dem Projekt unterscheiden, das den Dienst enthält, für den Sie Kontingentinformationen aufrufen.

    Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann das Weglassen zu einem Fehler vom Typ „Berechtigung verweigert“ führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.

Kontingentinformationen für eine Organisation ansehen

Führen Sie den folgenden Befehl aus, um die Kontingentinformationen desselben Dienstes für eine Organisation aufzurufen:

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

Ersetzen Sie Folgendes:

  • SERVICE_NAME: Der Dienstname mit den Kontingenten, die Sie sehen möchten. Der Dienstname für Compute Engine ist beispielsweise compute.googleapis.com.
  • ORGANIZATION_ID: die ID Ihrer Organisation
  • BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer für Kontingente und die Abrechnung. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als ob Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt hätten.

    Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Das kann sich von dem Projekt unterscheiden, das den Dienst enthält, für den Sie Kontingentinformationen aufrufen.

    Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann das Weglassen zu einem Fehler vom Typ „Berechtigung verweigert“ führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.

Beispielbefehle für gcloud-Kontingenteinstellungen

Dieser Abschnitt enthält Beispiele, die zeigen, wie gcloud beta quotas preferences-Befehle verwendet werden, um vorhandene Kontingenteinstellungen zu prüfen und den Kontingentwert anzupassen.

Die Ressource QuotaPreference steht für Ihre Kontingenteinstellung für eine bestimmte Dimensionskombination. Eine Dimension ist ein Attribut, das eine Region oder Zone oder eine dienstspezifische Dimension wie gpu_family oder network_id darstellt.

Auf bestehende Einstellungen prüfen

Führen Sie den folgenden Befehl aus, um nach vorhandenen Einstellungen zu suchen:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID_OR_NUMBER : die Projekt-ID oder Projektnummer
  • BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer für Kontingente und die Abrechnung. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als ob Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt hätten.

    Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Das kann sich von dem Projekt unterscheiden, für das Sie die Kontingenteinstellungen prüfen.

    Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann das Weglassen zu einem Fehler vom Typ „Berechtigung verweigert“ führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.

Auf vorhandene Einstellungen mit ausstehenden Kontingentanpassungen prüfen

Fügen Sie das Flag --reconciling-only=true wie im folgenden Befehl gezeigt hinzu, um nach vorhandenen Einstellungen mit ausstehenden Kontingentanpassungen zu suchen:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID_OR_NUMBER : die Projekt-ID oder Projektnummer
  • BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer für Kontingente und die Abrechnung. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als ob Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt hätten.

    Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Das kann sich von dem Projekt unterscheiden, für das Sie die Kontingenteinstellungen prüfen.

    Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann das Weglassen zu einem Fehler vom Typ „Berechtigung verweigert“ führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.

Anpassung der Kontingenterhöhung anfordern, wenn noch keine Kontingenteinstellung festgelegt wurde

Führen Sie den folgenden Befehl aus, um eine Anpassung der Kontingenterhöhung für eine bestimmte Region anzufordern, wenn noch keine Einstellung festgelegt wurde:

gcloud beta quotas preferences create --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=PREFERENCE_ID

Ersetzen Sie Folgendes:

  • PREFERRED_VALUE: der bevorzugte Kontingentwert
  • QUOTA_ID: der ID-Wert des Kontingents. Informationen zum Ermitteln dieses Werts finden Sie unter Kontingent-ID finden.
  • SERVICE_NAME: Der Dienstname mit den Kontingenten, die Sie sehen möchten. Der Dienstname für Compute Engine ist beispielsweise compute.googleapis.com.
  • PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer
  • BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer für Kontingente und die Abrechnung. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als ob Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt hätten.

    Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Das kann sich von dem Projekt unterscheiden, für das Sie eine Kontingentanpassung anfordern.

    Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann das Weglassen zu einem Fehler vom Typ „Berechtigung verweigert“ führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.

  • EMAIL: eine E-Mail-Adresse, die als Kontakt verwendet werden kann, falls Google Cloud weitere Informationen benötigt, bevor zusätzliches Kontingent gewährt werden kann

  • JUSTIFICATION: ein optionaler String, der Ihre Anfrage erläutert

  • PREFERENCE_ID: Eine optionale Einstellungs-ID. Wenn Sie keine Einstellungs-ID angeben, wird von der API eine UUID (Universally Unique Identifier) für Sie generiert.

Anpassung der Kontingenterhöhung anfordern, wenn eine Kontingenteinstellung festgelegt wurde

Führen Sie den folgenden Befehl aus, um eine Anpassung der Kontingenterhöhung für eine bestimmte Region anzufordern, und es ist bereits eine Einstellung vorhanden:

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

Ersetzen Sie Folgendes:

  • PREFERENCE_ID: die Einstellungs-ID, die als erstes Argument bei Verwendung des Befehls gcloud beta quotas preferences update erforderlich ist
  • PREFERRED_VALUE: der bevorzugte Kontingentwert
  • QUOTA_ID: der ID-Wert des Kontingents. Informationen zum Ermitteln dieses Werts finden Sie unter Kontingent-ID finden.
  • SERVICE_NAME: Der Dienstname mit den Kontingenten, die Sie sehen möchten. Der Dienstname für Compute Engine ist beispielsweise compute.googleapis.com.
  • PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer
  • BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer für Kontingente und die Abrechnung. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als ob Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt hätten.

    Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Das kann sich von dem Projekt unterscheiden, für das Sie eine Kontingentanpassung anfordern.

    Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann das Weglassen zu einem Fehler vom Typ „Berechtigung verweigert“ führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.

  • EMAIL: eine E-Mail-Adresse, die als Kontakt verwendet werden kann, falls Google Cloud weitere Informationen benötigt, bevor zusätzliches Kontingent gewährt werden kann

  • JUSTIFICATION: ein optionaler String, der Ihre Anfrage erläutert

Kontingenterhöhung mit einer Dimension anfordern

Führen Sie den folgenden Befehl aus, um eine Anpassung der Kontingenterhöhung mithilfe einer Dimension anzufordern:

gcloud beta quotas preferences create --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --dimensions=KEY1=VALUE1,KEY2=VALUE2,... --billing-project=BILLING_PROJECT_ID_OR_NUMBER \
    --email=EMAIL --justification=JUSTIFICATION --preference-id=PREFERENCE_ID

Ersetzen Sie Folgendes:

  • PREFERRED_VALUE: der bevorzugte Kontingentwert
  • QUOTA_ID: der ID-Wert des Kontingents. Informationen zum Ermitteln dieses Werts finden Sie unter Kontingent-ID finden.
  • SERVICE_NAME: Der Dienstname mit den Kontingenten, die Sie sehen möchten. Der Dienstname für Compute Engine ist beispielsweise compute.googleapis.com.
  • PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer
  • KEY1=VALUE1,KEY2=VALUE2,...: Eine optionale Liste, in der Sie Ihre Dimension als durch Kommas getrennte Liste von Schlüssel/Wert-Paaren angeben. Ihre Dimension kann beispielsweise die folgenden Compute Engine-Werte enthalten:
    • KEY1=VALUE1: region=us-east4
    • KEY2=VALUE2: gpu_family=NVIDIA_H100
  • BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer für Kontingente und die Abrechnung. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als ob Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt hätten.

    Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Das kann sich von dem Projekt unterscheiden, für das Sie eine Kontingentanpassung anfordern.

    Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann das Weglassen zu einem Fehler vom Typ „Berechtigung verweigert“ führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.

  • EMAIL: eine E-Mail-Adresse, die als Kontakt verwendet werden kann, falls Google Cloud weitere Informationen benötigt, bevor zusätzliches Kontingent gewährt werden kann

  • JUSTIFICATION: ein optionaler String, der Ihre Anfrage erläutert

  • PREFERENCE_ID: Eine optionale Einstellungs-ID. Wenn Sie keine Einstellungs-ID angeben, wird von der API eine UUID (Universally Unique Identifier) für Sie generiert.

Die Ausgabe enthält Daten, die für Ihre Konfiguration spezifisch sind, und sieht in etwa so aus:

{
    "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",
}

Vorhandene Kontingenteinstellung ansehen

Führen Sie den folgenden Befehl aus, um die Details der gerade erstellten Kontingenteinstellung aufzurufen:

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

Ersetzen Sie Folgendes:

  • PREFERENCE_ID: die Einstellungs-ID, die als erstes Argument bei Verwendung des Befehls gcloud beta quotas preferences describe erforderlich ist
  • PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer
  • BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer für Kontingente und die Abrechnung. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als ob Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt hätten.

    Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Das kann sich von dem Projekt unterscheiden, für das Sie die Kontingenteinstellung aufrufen.

    Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann das Weglassen zu einem Fehler vom Typ „Berechtigung verweigert“ führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.

Die Ausgabe enthält Daten, die für Ihre Konfiguration spezifisch sind, und sieht in etwa so aus:

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'

Kontingentanpassung über ein Kundenprojekt aktivieren

Ein Clientprojekt bezieht sich auf das Projekt, das von einer Anwendung oder einem Nutzer verwendet wird, um auf Google Cloud Ressourcen zuzugreifen und mit ihnen zu interagieren. Ein Ressourcenprojekt ist das zugrunde liegende Projekt, in dem diese Ressourcen gespeichert und verwaltet werden.

So aktivieren Sie die Kontingentanpassung über ein Clientprojekt mit der gcloud CLI:

  1. Client-Projekt erstellen:

    gcloud projects create CLIENT_PROJECT_ID
    gcloud config set project CLIENT_PROJECT_ID
    

    Ersetzen Sie CLIENT_PROJECT_ID durch die ID des Projekts, das Sie erstellen möchten. Projekt-IDs sind unveränderlich und können nur beim Erstellen des Projekts festgelegt werden. Sie müssen mit einem Kleinbuchstaben beginnen und können ASCII-Kleinbuchstaben, Ziffern oder Bindestriche enthalten. Die Projekt-ID muss zwischen 6 und 30 Zeichen lang sein.

  2. Aktivieren Sie die Cloud Quotas API im Clientprojekt:

    gcloud services enable cloudquotas.googleapis.com
    
  3. Erstellen Sie ein Dienstkonto im Clientprojekt:

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

    Ersetzen Sie Folgendes:

    • SA_NAME: der interne Name des neuen Dienstkontos. Wird verwendet, um ein IAM_ACCOUNT zu generieren (eine interne IAM-E-Mail-Adresse, die als Kennung des Dienstkontos verwendet wird), das an nachfolgende Befehle übergeben werden muss.
    • SA_DISPLAY_NAME: Der Anzeigename des Dienstkontos.
    • CLIENT_PROJECT_ID: die ID des Clientprojekts.
  4. Dienstkontoschlüssel erstellen:

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

    Ersetzen Sie Folgendes:

    • KEY_FILE: der Pfad zur JSON-Schlüsseldatei des Dienstkontos.
    • SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com: die E-Mail-Adresse des Dienstkontos.
  5. Gewähren Sie dem Dienstkonto IAM-Berechtigungen:

    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"
    

    Ersetzen Sie Folgendes:

    • CLIENT_PROJECT_ID: die ID des Clientprojekts.
    • RESOURCE_PROJECT_ID: die ID des Ressourcenprojekts.
    • SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com: die E-Mail-Adresse des Dienstkontos.
  6. Aktivieren Sie das Dienstkonto mit dem Dienstkontoschlüssel, den Sie zuvor erstellt haben:

    gcloud auth activate-service-account --key-file=KEY_FILE
    
  7. Aktivieren Sie die Kontingentanpassung für Ihr Ressourcenprojekt, indem Sie das Projekt und die Aktivierungseinstellung angeben:

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

    Die Aktivierungseinstellung ist erforderlich, wenn Sie die gcloud CLI verwenden, und muss auf enabled oder disabled festgelegt werden.

  8. Optional: Führen Sie den folgenden Befehl aus, um die aktuellen Einstellungen für die Kontingentanpassung aufzurufen:

    gcloud beta quotas adjuster settings describe --project=RESOURCE_PROJECT_ID 
    

    Die Ausgabe sieht etwa so aus wie im folgenden Beispiel.

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

Wenn Sie die Kontingentanpassung für mehrere Kundenprojekte aktivieren möchten, folgen Sie den vorherigen Schritten 5 bis 8. Dabei müssen die folgenden Bedingungen erfüllt sein:

  • Die Cloud Quotas API ist für das Clientprojekt aktiviert.
  • Achten Sie darauf, dass das Dienstkonto die IAM-Rolle cloudquotas.admin für alle Ressourcenprojekte hat, für die Sie den Kontingentanpasser aktivieren möchten.

Andere Dienste mit kontingentbezogenen gcloud CLI-Befehlen

Zusätzlich zu gcloud beta quotas haben einige Dienste einen eigenen Befehlszeilenzugriff auf Informationen zu Kontingenten und zur Ressourcennutzung.

In Compute Engine können Sie beispielsweise mithilfe von auf Kontingentinformationen zugreifen. Weitere Informationen finden Sie in den folgenden Compute Engine-Abschnitten:

Nächste Schritte