Die folgenden Abschnitte enthalten gcloud quotas info- und gcloud 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 der Projektebene vorgenommen werden. Eine begrenzte Anzahl von Produkten unterstützt Anpassungen der Kontingenterhöhung auf Organisationsebene. Ob ein Google Cloud Produkt Anpassungen der Kontingenterhöhung auf Organisationsebene unterstützt, erfahren Sie in der Dokumentation für dieses Produkt.
Sie können Anpassungen der Kontingentverringerung für Kontingente auf Projekt-, Organisations- und Ordnerebene anfordern.
Hinweis
Bevor Sie die gcloud CLI verwenden, müssen Sie sie 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 die folgenden Komponenten installieren und initialisieren:
Installieren Sie die gcloud CLI.
Wenn Sie Cloud Shell verwenden, können Sie diesen Schritt überspringen, da die gcloud CLI vorinstalliert ist.
Initialisieren Sie die gcloud CLI.
Installieren Sie die Beta-Komponente mit dem folgenden Befehl:
gcloud components install beta
Kontingent-ID ermitteln
Mehrere gcloud CLI-Befehle in diesem Dokument beziehen sich auf Ihren Kontingent-ID-Wert. Sie können die Kontingent-ID über die Google Cloud Console, die gcloud CLI, Clientbibliotheken oder die REST API ermitteln. In diesem Abschnitt wird beschrieben, wie Sie die Kontingent-ID entweder über die Console oder die gcloud CLI ermitteln. Google Cloud
Console
Gehen Sie in der Google Cloud Console zu IAM und Verwaltung > Kontingente und Systemlimits:
Klicken Sie auf Filtern , um nach Ihrem Dienst zu filtern.
Wenn die Spalte Limitname nicht angezeigt wird, klicken Sie auf das Symbol Spaltenanzeigeoptionen. Wählen Sie Limitname aus und klicken Sie auf OK.
In der Spalte Limitname wird die Kontingent-ID angezeigt.
gcloud
Führen Sie den folgenden Befehl aus, um den Kontingent-ID-Wert mit der gcloud CLI zu ermitteln und Ihre Kontingentinformationen für den angegebenen Dienst aufzulisten:
Geben Sie den folgenden gcloud CLI-Befehl in einem Terminalfenster ein:
gcloud quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \ --billing-project=BILLING_PROJECT_ID_OR_NUMBERErsetzen Sie Folgendes:
SERVICE_NAME: der Dienstname mit den Kontingenten, die Sie sehen möchten. Der Dienstname für Compute Engine ist beispielsweisecompute.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:
BILLING_PROJECT_ID_OR_NUMBER: die ID oder Projektnummer des Projekts, dessen Cloud Quotas API-Kontingent Sie für die Ausführung dieses Befehls verwenden möchten. Das kann sich von dem Projekt unterscheiden, das den Dienst enthält, für den Sie die Kontingent-ID ermitteln.Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann das Weglassen des Flags zu einem Fehler wegen fehlender Berechtigungen führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.
Die Ausgabe des Befehls
gcloud quotas info listenthä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" ] ... } ] }, ... ] ...
Suchen Sie nach dem Wert, der
quotaIdentspricht, und verwenden Sie ihn, wenn SieQUOTA_IDin den folgenden Abschnitten angeben.
Beispiele für gcloud-Kontingentinformationsbefehle
Dieser Abschnitt enthält Beispiele, die zeigen, wie gcloud 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 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 Kontingent-ID-Wert. Informationen zum Ermitteln dieses Werts finden Sie unter Kontingent-ID ermitteln.SERVICE_NAME: der Dienstname mit den Kontingenten, die Sie sehen möchten. Der Dienstname für Compute Engine ist beispielsweisecompute.googleapis.com.PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer.BILLING_PROJECT_ID_OR_NUMBER: die ID oder Projektnummer des Projekts, dessen Cloud Quotas API-Kontingent Sie für die Ausführung dieses Befehls 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 des Flags zu einem Fehler wegen fehlender Berechtigungen 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 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 beispielsweisecompute.googleapis.com.ORGANIZATION_ID: die ID Ihrer Organisation.BILLING_PROJECT_ID_OR_NUMBER: die ID oder Projektnummer des Projekts, dessen Cloud Quotas API-Kontingent Sie für die Ausführung dieses Befehls 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 des Flags zu einem Fehler wegen fehlender Berechtigungen führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.
Beispielbefehle für gcloud-Kontingenteinstellungen
Dieser Abschnitt enthält Beispiele, die zeigen, wie gcloud 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 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 ID oder Projektnummer des Projekts, dessen Cloud Quotas API-Kontingent Sie für die Ausführung dieses Befehls 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 des Flags zu einem Fehler wegen fehlender Berechtigungen 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 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 ID oder Projektnummer des Projekts, dessen Cloud Quotas API-Kontingent Sie für die Ausführung dieses Befehls 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 des Flags zu einem Fehler wegen fehlender Berechtigungen 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 Kontingentanpassung mit der gcloud CLI anzufordern:
gcloud 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
Ersetzen Sie Folgendes:
PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer.SERVICE_NAME: der Dienstname mit den Kontingenten, die Sie anpassen möchten. Der Dienstname für Compute Engine ist beispielsweisecompute.googleapis.com.QUOTA_ID: der Kontingent-ID-Wert. Informationen zum Ermitteln dieses Werts finden Sie unter Kontingent-ID ermitteln.DIMENSIONS: die anzupassenden Dimensionen, angegeben als durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, z. B.region=us-east4,gpu_family=NVIDIA_H100. Weitere Informationen zu Kontingentdimensionen finden Sie unter Dimensionen für Cloud-Kontingente konfigurieren.PREFERRED_VALUE: der bevorzugte Kontingentwert.BILLING_PROJECT_ID_OR_NUMBER: die ID oder Projektnummer des Projekts, dessen Cloud Quotas API-Kontingent Sie für die Ausführung dieses Befehls verwenden möchten. Das kann sich von dem Projekt unterscheiden, das den Dienst enthält, für den Sie eine Kontingentanpassung anfordern.Wenn Sie das Abrechnungsprochen bereits festgelegt haben bei der Einrichtung der gcloud CLI, ist dieses Flag optional. Andernfalls kann das Weglassen des Flags zu einem Fehler wegen fehlender Berechtigungen 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 werden, bevor zusätzliches Kontingent gewährt werden kann.JUSTIFICATION: eine optionale Zeichenfolge, in der Sie Ihre Anfrage erläutern.PREFERENCE_ID: eine optionale Einstellungs-ID. Wenn Sie keine Einstellungs-ID angeben, generiert die API eine UUID (Universally Unique Identifier) für Sie.
Die Ausgabe sieht dann ungefähr so aus:
{ "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", }
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 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 Befehlsgcloud quotas preferences updateerforderlich ist.PREFERRED_VALUE: der bevorzugte Kontingentwert.QUOTA_ID: der Kontingent-ID-Wert. Informationen zum Ermitteln dieses Werts finden Sie unter Kontingent-ID ermitteln.SERVICE_NAME: der Dienstname mit den Kontingenten, die Sie sehen möchten. Der Dienstname für Compute Engine ist beispielsweisecompute.googleapis.com.PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer.BILLING_PROJECT_ID_OR_NUMBER: die ID oder Projektnummer des Projekts, dessen Cloud Quotas API-Kontingent Sie für die Ausführung dieses Befehls verwenden möchten. Das kann sich von dem Projekt unterscheiden, das den Dienst enthält, für den 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 des Flags zu einem Fehler wegen fehlender Berechtigungen führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.
EMAIL: eine E-Mail-Adresse, die als Kontakt verwendet werden kann, falls weitere Informationen benötigt werden, bevor zusätzliches Kontingent gewährt werden kann. Google CloudJUSTIFICATION: eine optionale Zeichenfolge, in der Sie Ihre Anfrage erläutern.
Vorhandene Kontingenteinstellung ansehen
Führen Sie den folgenden Befehl aus, um die Details der gerade erstellten Kontingenteinstellung aufzurufen:
gcloud 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 Befehlsgcloud quotas preferences describeerforderlich ist.PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer.BILLING_PROJECT_ID_OR_NUMBER: die ID oder Projektnummer des Projekts, dessen Cloud Quotas API-Kontingent Sie für die Ausführung dieses Befehls verwenden möchten. Das kann sich von dem Projekt unterscheiden, das den Dienst enthält, für den 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 des Flags zu einem Fehler wegen fehlender Berechtigungen führen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.
Die Ausgabe enthält Daten, die für Ihre Konfiguration spezifisch sind, und sieht etwa so aus wie im folgenden Beispiel:
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 Clientprojekt aktivieren
Ein Clientprojekt ist das Projekt, das von einer Anwendung oder einem Nutzer verwendet wird, um auf Ressourcen zuzugreifen und mit ihnen zu interagieren Google Cloud . 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:
Erstellen Sie ein Clientprojekt:
gcloud projects create CLIENT_PROJECT_ID gcloud config set project CLIENT_PROJECT_IDErsetzen Sie
CLIENT_PROJECT_IDdurch die ID des Projekts, das Sie erstellen möchten. Projekt-IDs sind unveränderlich und können nur während der Projekterstellung festgelegt werden. Sie müssen mit einem Kleinbuchstaben beginnen und können ASCII-Kleinbuchstaben, Ziffern oder Bindestriche enthalten. Projekt-IDs müssen zwischen 6 und 30 Zeichen lang sein.Aktivieren Sie die Cloud Quotas API für das Clientprojekt:
gcloud services enable cloudquotas.googleapis.comErstellen Sie ein Dienstkonto im Clientprojekt:
gcloud iam service-accounts create SA_NAME \ --display-name SA_DISPLAY_NAME \ --project=CLIENT_PROJECT_IDErsetzen 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 ID des Dienstkontos verwendet wird). Diese muss an nachfolgende Befehle übergeben werden.SA_DISPLAY_NAME: der Anzeigename des Dienstkontos.CLIENT_PROJECT_ID: die ID des Clientprojekts.
Erstellen Sie einen Dienstkontoschlüssel:
gcloud iam service-accounts keys create KEY_FILE \ --iam-account=SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.comErsetzen Sie Folgendes:
KEY_FILE: der Pfad zur JSON-Datei des Dienstkontoschlüssels.SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com: die E-Mail-Adresse des Dienstkontos.
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.
Aktivieren Sie das Dienstkonto mit dem zuvor erstellten Dienstkontoschlüssel:
gcloud auth activate-service-account --key-file=KEY_FILEAktivieren Sie die Kontingentanpassung für Ihr Ressourcenprojekt, indem Sie das Projekt und die Aktivierungseinstellung angeben:
gcloud quotas adjuster settings update --project=RESOURCE_PROJECT_ID \ --enablement=enabledDie Aktivierungseinstellung ist erforderlich, wenn Sie die gcloud CLI verwenden, und muss auf
enabledoderdisabledfestgelegt werden.Optional: Führen Sie den folgenden Befehl aus, um die aktuellen Einstellungen für die Kontingentanpassung aufzurufen:
gcloud quotas adjuster settings describe --project=RESOURCE_PROJECT_IDDie 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 Clientprojekte aktivieren möchten, führen Sie die vorherigen Schritte 5 bis 8 aus. Dabei müssen die folgenden Bedingungen erfüllt sein:
- Die Cloud Quotas API ist für das Clientprojekt aktiviert.
- Das Dienstkonto hat die IAM-Rolle
cloudquotas.adminfür alle Ressourcenprojekte, für die Sie die Kontingentanpassung aktivieren möchten.
Andere Dienste mit kontingentbezogenen gcloud CLI-Befehlen
Zusätzlich zu gcloud 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:
- Zuteilungskontingente
- Übersicht über gcloud CLI Compute
- Im Abschnitt gcloud CLI Compute der Google Cloud SDK-Referenz
Nächste Schritte
Informationen zur Fehlerbehebung bei
gcloud quotasBefehlen finden Sie unter Fehlerbehebung bei gcloud CLI-Fehlern.Weitere Informationen zu
gcloud quotas-Befehlen und -Flags finden Sie in der Google Cloud CLI-Referenz im Abschnitt.Weitere Informationen zur Terminologie zu Kontingenten und Systemlimits finden Sie unter Terminologie zu Kontingenten und Systemlimits.