Kontingente über die gcloud alpha CLI aufrufen und verwalten

Die folgenden Abschnitte enthalten gcloud alpha quotas info- und gcloud alpha 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:

Anpassungen der Kontingenterhöhung müssen auf Projektebene vorgenommen werden und unterliegen der Genehmigung von Google Cloud.
You can request quota decrease adjustments for project-, folder-, and auf Organisationsebene.
Die Cloud Quotas API unterstützt nur Vorgänge auf Projektebene. Vorgänge auf Ordner- und Organisationsebene werden nicht unterstützt.

Hinweise

Bevor Sie die gcloud CLI verwenden können, 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 Alpha-Komponente mit dem folgenden Befehl:
```
gcloud components install alpha
```

Kontingent-ID ermitteln

Mehrere gcloud CLI-Befehle auf dieser Seite beziehen sich auf Ihren Kontingent-ID-Wert. Sie finden die Kontingent-ID in der Google Cloud Console, der gcloud CLI, den Clientbibliotheken oder der REST API. In diesem Abschnitt erfahren Sie, wie Sie die Kontingent-ID entweder über die Google Cloud Console oder die gcloud CLI ermitteln.

Console

Rufen Sie die Seite Kontingente und Seite zu den Systemlimits auf:
Zur Seite „Kontingente und Systemlimits"
Klicken Sie auf Filter, um nach Ihrem Dienst zu filtern.
Wenn die Spalte Limit name (Limitierungsname) 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

Verwenden Sie zum Ermitteln des Kontingent-ID-Werts den folgenden Befehl der gcloud CLI, um Ihre Kontingentinformationen für den angegebenen Dienst aufzulisten:

Geben Sie den folgenden gcloud CLI-Befehl in einem Terminalfenster ein:
```
gcloud alpha quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER
```
Ersetzen Sie Folgendes:
- SERVICE_NAME: Der Name des Dienstes mit den gewünschten Kontingenten. Der Dienstname für die Compute Engine lautet beispielsweise compute.googleapis.com.
- PROJECT_ID_OR_NUMBER: 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, die für Kontingente und die Abrechnung verwendet wird. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als hätten Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt.
  
  Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Diese kann sich vom Projekt unterscheiden, das den Dienst enthält, für den Sie die Kontingent-ID ermitteln möchten.
  
  Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann es zu einem Fehler vom Typ „Berechtigung verweigert“ kommen. Weitere Informationen finden Sie unter Kontingentprojekt festlegen.

Die Ausgabe des Befehls gcloud alpha 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"
                ]
                ...
            }
        ]
    },
    ...
]
...

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 alpha 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 alpha 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 Wert der Kontingent-ID. Wie Sie diesen Wert ermitteln, erfahren Sie unter Kontingent-ID ermitteln.
SERVICE_NAME: Der Dienstname mit den gewünschten Kontingenten. Der Dienstname für die Compute Engine lautet beispielsweise compute.googleapis.com.
PROJECT_ID_OR_NUMBER: Projekt-ID oder Projektnummer
BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer, die für Kontingente und die Abrechnung verwendet wird. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als hätten Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt.

Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Das kann vom Projekt abweichen, das den Dienst enthält, für den Sie sich die Kontingentinformationen ansehen.

Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann es zu einem Fehler vom Typ „Berechtigung verweigert“ kommen. 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 alpha 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 gewünschten Kontingenten. Der Dienstname für die Compute Engine lautet beispielsweise compute.googleapis.com.
ORGANIZATION_ID: die ID Ihrer Organisation
BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer, die für Kontingente und die Abrechnung verwendet wird. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als hätten Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt.

Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Das kann vom Projekt abweichen, das den Dienst enthält, für den Sie sich die Kontingentinformationen ansehen.

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

Beispielbefehle für gcloud-Kontingenteinstellungen

Dieser Abschnitt enthält Beispiele, die zeigen, wie gcloud alpha 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 alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Ersetzen Sie Folgendes:

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

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 es zu einem Fehler vom Typ „Berechtigung verweigert“ kommen. 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 alpha 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 : Projekt-ID oder Projektnummer
BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer, die für Kontingente und die Abrechnung verwendet wird. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als hätten Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt.

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 es zu einem Fehler vom Typ „Berechtigung verweigert“ kommen. 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 alpha 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 --preference-id=PREFERENCE_ID

Ersetzen Sie Folgendes:

PREFERRED_VALUE: der bevorzugte Kontingentwert
QUOTA_ID: der Wert der Kontingent-ID. Wie Sie diesen Wert ermitteln, erfahren Sie unter Kontingent-ID ermitteln.
SERVICE_NAME: Der Dienstname mit den gewünschten Kontingenten. Der Dienstname für die Compute Engine lautet beispielsweise compute.googleapis.com.
PROJECT_ID_OR_NUMBER: Projekt-ID oder Projektnummer
BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer, die für Kontingente und die Abrechnung verwendet wird. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als hätten Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt.

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

Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann es zu einem Fehler vom Typ „Berechtigung verweigert“ kommen. 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, um eine Entscheidung zu treffen, bevor ein zusätzliches Kontingent gewährt werden kann
PREFERENCE_ID: Optionale Einstellungs-ID. Wenn Sie keine Einstellungs-ID angeben, generiert die API eine UUID (Universally Unique Identifier) für Sie.

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 alpha quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --email=EMAIL --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Ersetzen Sie Folgendes:

PREFERENCE_ID: die Einstellungs-ID, die als erstes Argument beim Befehl gcloud alpha quotas preferences update erforderlich ist
PREFERRED_VALUE: der bevorzugte Kontingentwert
QUOTA_ID: der Wert der Kontingent-ID. Wie Sie diesen Wert ermitteln, erfahren Sie unter Kontingent-ID ermitteln.
SERVICE_NAME: Der Dienstname mit den gewünschten Kontingenten. Der Dienstname für die Compute Engine lautet beispielsweise compute.googleapis.com.
PROJECT_ID_OR_NUMBER: Projekt-ID oder Projektnummer
EMAIL: eine E-Mail-Adresse, die als Kontakt verwendet werden kann, falls Google Cloud weitere Informationen benötigt, um eine Entscheidung zu treffen, bevor ein zusätzliches Kontingent gewährt werden kann
BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer, die für Kontingente und die Abrechnung verwendet wird. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als hätten Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt.

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

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

Kontingenterhöhung mithilfe einer Dimension beantragen

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

gcloud alpha 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 Wert der Kontingent-ID. Wie Sie diesen Wert ermitteln, erfahren Sie unter Kontingent-ID ermitteln.
SERVICE_NAME: Der Dienstname mit den gewünschten Kontingenten. Der Dienstname für die Compute Engine lautet beispielsweise compute.googleapis.com.
PROJECT_ID_OR_NUMBER: Projekt-ID oder Projektnummer
KEY1=VALUE1,KEY2=VALUE2,...: eine optionale Liste, in der die Dimension als durch Kommas getrennte Liste von Schlüssel/Wert-Paaren angegeben wird. In Ihrer Dimension können Sie beispielsweise die folgenden Compute Engine-Werte angeben:
- KEY1=VALUE1: region=us-east4
- KEY2=VALUE2: gpu_family=NVIDIA_H100
BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer, die für Kontingente und die Abrechnung verwendet wird. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als hätten Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt.

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

Wenn Sie das Abrechnungsprojekt bereits bei der Einrichtung der gcloud CLI festgelegt haben, ist dieses Flag optional. Andernfalls kann es zu einem Fehler vom Typ „Berechtigung verweigert“ kommen. 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, um eine Entscheidung zu treffen, bevor ein zusätzliches Kontingent gewährt werden kann
JUSTIFICATION: ein optionaler String, der Ihre Anfrage erläutert
PREFERENCE_ID: Optionale Einstellungs-ID. Wenn Sie keine Einstellungs-ID angeben, generiert die API eine UUID (Universally Unique Identifier) für Sie.

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 soeben erstellten Kontingenteinstellung aufzurufen:

gcloud alpha 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 beim Befehl gcloud alpha quotas preferences describe erforderlich ist
PROJECT_ID_OR_NUMBER: Projekt-ID oder Projektnummer
BILLING_PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer, die für Kontingente und die Abrechnung verwendet wird. Wenn Sie einen gcloud-Befehl ausführen, wirkt sich das auf das Kontingent aus, als hätten Sie die entsprechende Anfrage direkt über eine REST- oder RPC-API gestellt.

Geben Sie das Projekt an, dessen Kontingent Sie verwenden möchten. Dieser kann sich vom 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 es zu einem Fehler vom Typ „Berechtigung verweigert“ kommen. 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'

Andere Dienste mit kontingentbezogenen gcloud CLI-Befehlen

Zusätzlich zu gcloud alpha 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 alpha quotas-Befehlen finden Sie unter Fehlerbehebung bei gcloud CLI-Fehlern.
Weitere Informationen zu gcloud alpha quotas-Befehlen und -Flags finden Sie in der Google Cloud CLI-Referenz im Abschnitt gcloud Alpha – Kontingente.
Weitere Informationen zur Terminologie zu Kontingenten finden Sie unter Informationen zu Kontingentwerten und Systemlimits.