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 beispielsweiselogging.googleapis.com
.PROJECT_ID_OR_NUMBER
: die Projekt-ID oder ProjektnummerWenn Sie Ihre Projekt-ID über die Google Cloud Console ermitteln möchten, rufen Sie die Seite "Resource Manager" auf:
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 SieQUOTA_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 KontingentsSERVICE_NAME
: der Dienstname mit Kontingenten, die Sie sich ansehen möchten. Der Dienstname für Cloud Logging lautet beispielsweiselogging.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 beispielsweiselogging.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 KontingentwertQUOTA_ID
: die ID des KontingentsSERVICE_NAME
: der Dienstname mit Kontingenten, die Sie sich ansehen möchten. Der Dienstname für Cloud Logging lautet beispielsweiselogging.googleapis.com
.PROJECT_ID_OR_NUMBER
: die Projekt-ID oder ProjektnummerPREFERENCE_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-IDPREFERRED_VALUE</var>"}}
: der bevorzugte KontingentwertQUOTA_ID
: die ID des KontingentsSERVICE_NAME
: der Dienstname mit Kontingenten, die Sie sich ansehen möchten. Der Dienstname für Cloud Logging lautet beispielsweiselogging.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-IDPROJECT_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.