Kontingente über die gcloud alpha CLI aufrufen

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:

Alle Anpassungen der Kontingenterhöhung unterliegen der Genehmigung von Google Cloud.
Für Kontingente auf Projektebene können Sie eine Erhöhung und Verringerung der Kontingente anfordern.
You can request quota decrease adjustments for project-, folder-, and auf Organisationsebene.

Hinweise

Bevor Sie beginnen, 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 QUOTA_ID.

gcloud CLI installieren und initialisieren

Stellen Sie zur Verwendung der gcloud CLI sicher, dass Sie die aktuelle Version der gcloud CLI einschließlich der Komponente für Alpha-Befehle installiert und initialisiert haben. Wenn Sie Cloud Shell für die Interaktion mit Google Cloud verwenden, wird das Google Cloud CLI für Sie installiert.

Kontingent-ID ermitteln

Viele der gcloud CLI-Befehle auf dieser Seite beziehen sich auf Ihren Kontingent-ID-Wert.

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
```
Ersetzen Sie Folgendes:
- SERVICE_NAME: der Dienstname mit Kontingenten, die Sie sich ansehen möchten. Der Dienstname für Cloud Logging lautet beispielsweise logging.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

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

Ersetzen Sie Folgendes:

QUOTA_ID: die ID des Kontingents
SERVICE_NAME: der Dienstname mit Kontingenten, die Sie sich ansehen möchten. Der Dienstname für Cloud Logging lautet beispielsweise logging.googleapis.com.
PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer

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

Ersetzen Sie Folgendes:

SERVICE_NAME: der Dienstname mit Kontingenten, die Sie sich ansehen möchten. Der Dienstname für Cloud Logging lautet beispielsweise logging.googleapis.com.
ORGANIZATION_ID: die ID Ihrer Organisation

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

Ersetzen Sie PROJECT_ID_OR_NUMBER durch die Projekt-ID oder Projektnummer.

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

Ersetzen Sie PROJECT_ID_OR_NUMBER durch die Projekt-ID oder Projektnummer.

Eine Anpassung der Kontingenterhöhung für eine bestimmte Region anfordern, wenn 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 --preference-id=PREFERENCE_ID

Ersetzen Sie Folgendes:

PREFERRED_VALUE: der bevorzugte Kontingentwert
QUOTA_ID: die ID des Kontingents
SERVICE_NAME: der Dienstname mit Kontingenten, die Sie sich ansehen möchten. Der Dienstname für Cloud Logging lautet beispielsweise logging.googleapis.com.
PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer
PREFERENCE_ID: die Einstellungs-ID

Anpassung der Kontingenterhöhung für eine bestimmte Region anfordern, wenn eine Kontingenteinstellung festgelegt wurde

Führen Sie den folgenden Befehl noch einmal 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

Ersetzen Sie Folgendes:

PREFERENCE_ID: die Einstellungs-ID
PREFERRED_VALUE</var>"}}: der bevorzugte Kontingentwert
QUOTA_ID: die ID des Kontingents
SERVICE_NAME: der Dienstname mit Kontingenten, die Sie sich ansehen möchten. Der Dienstname für Cloud Logging lautet beispielsweise logging.googleapis.com.
PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer

Vorhandene Kontingenteinstellung abrufen

Führen Sie den folgenden Befehl aus, um eine vorhandene Kontingenteinstellung abzurufen:

gcloud alpha quotas preferences describe PREFERENCE_ID project=PROJECT_ID_OR_NUMBER

Ersetzen Sie Folgendes:

PREFERENCE_ID: die Einstellungs-ID
PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer

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

Eine vollständige Liste der gcloud alpha quotas-Befehle und -Flags finden Sie in der Google Cloud CLI-Referenz unter gcloud Alpha -Kontingente.

Weitere Informationen zur Terminologie zu Kontingenten finden Sie unter Informationen zu Kontingentwerten und Systemlimits.