Cloud-Kontingent-Dimensionen konfigurieren

Cloud-Kontingent-Dimensionen sind verschiedene Möglichkeiten, die Ressourcennutzung in Google Cloud zu messen. Dimensionen sind in der Regel eine Region, eine Zone, ein Google Cloud-Nutzer oder ein Produktattribut.

Die Cloud Quotas API stellt Dimensionen als Schlüssel/Wert-Paare dar. key ist der Dimensionsname (z. B. region). value ist der zugewiesene Wert für die Dimension (z. B. eine Region wie us-central1).

In Compute Engine wird beispielsweise die VM-Nutzung mithilfe verschiedener Dimensionen gemessen. Die Dimension region misst die Anzahl der VMs in einer bestimmten Region. Die Compute Engine bietet auch eine Reihe von Produktattributdimensionen, darunter gpu_family. Die Dimension gpu_family misst die Anzahl der GPUs einer bestimmten Familie in Ihrem Google Cloud-Projekt.

Dimensionen aufrufen

Sie können die Dimensionen für Kontingente und Systemlimits in der Google Cloud Console, mit der Google Cloud CLI, durch Abfragen der REST API oder über Clientbibliotheken aufrufen. Wenn Sie Dimensionen aufrufen möchten, für die Sie keinen Wert angegeben haben, verwenden Sie die gcloud CLI. Mit der gcloud CLI können Sie auch Dimensionen für Kontingente und Systemlimits aufrufen, die keine regionalen oder zonalen Dimensionen haben, wenn die zugehörige Ressource in Ihrem Projekt noch nicht verwendet wird. In diesem Abschnitt erfahren Sie, wie Sie Dimensionen über die Console und die gcloud CLI aufrufen.

Console

Rufen Sie die Seite Kontingente und Seite zu den Systemlimits auf:
Zur Seite „Kontingente und Systemlimits"

In der Tabelle auf dieser Seite werden in der Spalte Dimensionen Dimensionen angezeigt.
Wenn die Spalte Dimensionen nicht angezeigt wird, gehen Sie so vor: Andernfalls überspringen Sie diesen Schritt.
1. Klicken Sie auf Spaltenanzeigeoptionen.
2. Dimensionen auswählen
3. Klicken Sie auf OK. Die Spalte Dimensionen wird in der Tabelle angezeigt.
Wenn Sie die Ergebnisse filtern möchten, geben Sie einen Namen oder Wert für das Attribut in das Feld neben Filter ein.
- Wenn Sie nach Produkt filtern möchten, geben Sie den Produktnamen ein und wählen Sie ihn aus der angezeigten Liste aus.
- Wenn Sie nach einer Dimension filtern möchten, geben Sie sie im folgenden Format ein: dimension_name:dimension_value. Wenn Sie beispielsweise die Kontingente und Systemlimits für die Region „us-central1“ sehen möchten, geben Sie region:us-central ein.

Leere Dimensionen verstehen

Manchmal ist die Spalte Dimensionen leer. Dies kann einen der folgenden Gründe haben:

Der Wert für das Kontingent oder das Systemlimit ist der Standardwert und gilt für alle Dimensionen. Bei einigen Kontingenten und Systemlimits wird in der Konsole eine Zeile mit dem Standardkontingent oder dem Standardwert für das Systemlimit angezeigt. Da der Standardwert für alle Dimensionswerte gilt, ist die Spalte Dimensionen leer. Diese Einträge finden Sie in der Spalte Name. In der Spalte Name sind diese Einträge am Ende des Kontingent- oder Systemgrenzwertnamens in Klammern mit dem Wort „standard“ gekennzeichnet.

Das Kontingent SetIamPolicyRequestsPerMinutePerProject ist beispielsweise an der Dimension region definiert. In der Console werden ein Referenzeintrag und ein Eintrag für jede Region angezeigt. In der Spalte Name wird der Referenzeintrag als „SetIAMPolicy-Anfragen pro Minute und Region (Standard)“ aufgeführt. Bei diesem Eintrag ist die Spalte Dimensionen leer.
Es werden keine Dimensionen angewendet. Das Compute Engine-Kontingent NETWORKS-per-project ist beispielsweise nicht mit einem Regions-, Zonen- oder Produktattribut verknüpft. Daher sind keine Dimensionen zu sehen.

gcloud

Mit der gcloud CLI können Sie Dimensionen für ein einzelnes Kontingent oder Systemlimit oder für alle Kontingente und Systemlimits aufrufen, die mit einem bestimmten Produkt verknüpft sind. Das Aufrufen von Dimensionen für ein einzelnes Kontingent oder Systemlimit ist in der Regel schneller als das Aufrufen von Dimensionen für alle Kontingente und Systemlimits, die mit einem Produkt verknüpft sind. Die Antwort auf eine Abfrage für ein einzelnes Kontingent umfasst in der Regel etwa 200 Zeilen. Die Antwort auf eine Abfrage für ein Produkt kann mehr als 2.000 Zeilen umfassen.

Dimensionen für ein einzelnes Kontingent oder Systemlimit mit gcloud aufrufen

Wenn Sie mit der gcloud CLI Dimensionen für ein einzelnes Kontingent oder Systemlimit aufrufen möchten, führen Sie den folgenden Befehl im Terminal aus:

gcloud alpha quotas info describe QUOTA_ID --project=PROJECT_ID --service=SERVICE_ID

Ersetzen Sie Folgendes:

QUOTA_ID: die ID für das Kontingent oder Systemlimit. Wenn Sie Ihre Kontingent-ID nicht kennen, wählen Sie eine der folgenden Optionen aus:
1. Sie finden sie in der Console, wie unter Kontingent-ID ermitteln beschrieben.
2. Rufen Sie alle Dimensionen für das Produkt auf, das mit dem gewünschten Kontingent oder Systemlimit verknüpft ist. Für diesen Befehl ist keine Kontingent-ID erforderlich. Weitere Informationen finden Sie im Abschnitt Dimensionen für ein Produkt mit der gcloud CLI ansehen.
PROJECT_ID: ID Ihres Google Cloud-Projekts. Wählen Sie eine der folgenden Optionen aus, um Ihre Projekt-ID zu ermitteln:
1. Informationen zum Ermitteln der Projekt-ID über die Console finden Sie unter Projekte identifizieren.
2. Wenn Sie Ihr aktuelles Projekt in der gcloud CLI-Konfiguration als Standardprojekt festgelegt haben, können Sie die Projekt-ID mit dem folgenden gcloud-Befehl im Terminal abrufen:
```
gcloud config get-value project
```
SERVICE_ID: die Dienst-ID des Produkts, das mit dem Kontingent oder Systemlimit verknüpft ist. Wenn das Kontingent beispielsweise für Compute Engine A2-CPUs gilt, lautet die Dienst-ID compute.googleapis.com.

Dimensionen für ein Produkt mit der gcloud CLI aufrufen

Wenn Sie mit der gcloud CLI Dimensionen für ein einzelnes Kontingent oder Systemlimit aufrufen möchten, führen Sie den folgenden Befehl im Terminal aus:

gcloud alpha quotas info list --project=PROJECT_ID --service=SERVICE_ID

Ersetzen Sie Folgendes:

PROJECT_ID: ID Ihres Google Cloud-Projekts. Wählen Sie eine der folgenden Optionen aus, um Ihre Projekt-ID zu ermitteln:
1. Informationen zum Ermitteln der Projekt-ID über die Console finden Sie unter Projekte identifizieren.
2. Wenn Sie Ihr aktuelles Projekt in der gcloud CLI-Konfiguration als Standardprojekt festgelegt haben, können Sie die Projekt-ID mit dem folgenden gcloud-Befehl im Terminal abrufen:
```
gcloud config get-value project
```
SERVICE_ID: die Dienst-ID des Produkts, das mit dem Kontingent oder Systemlimit verknüpft ist. Wenn das Kontingent beispielsweise für Compute Engine A2-CPUs gilt, lautet die Dienst-ID compute.googleapis.com.

Dimensionspriorität

Einige Anwendungsfälle für die Cloud Quotas API haben komplexe Dimensionskonfigurationen. Kontingente können auf einer detaillierteren Ebene konfiguriert werden als nur Regionen und Zonen. Sie können diesen Detaillierungsgrad erreichen, wenn Sie dienstspezifische Dimensionen verwenden. Beispiel: gpu_family und network_id sind dienstspezifische Dimensionen im Compute Engine-Dienst. Dimensionen werden von jedem einzelnen Dienst definiert und jeder Dienst kann einen anderen Satz von dienstspezifischen Dimensionen haben.

Bei der Arbeit mit Standortdimensionen oder dienstspezifischen Dimensionen gilt die folgende Priorität:

Eine Kontingenteinstellungskonfiguration mit allen angegebenen standort- und dienstspezifischen Dimensionen hat Vorrang vor allen anderen Konfigurationen.
Konfigurationen, die Standortdimensionen angeben, haben nur Vorrang vor Konfigurationen, die nur dienstspezifische Dimensionen enthalten.

Dimensionen kombinieren

In einer Konfiguration der Kontingenteinstellung können Sie Dimensionen so kombinieren:

Die Konfiguration kann sowohl Standortdimensionen als auch dienstspezifische Dimensionen enthalten. Dies ist die höchste Reihenfolge.
Die Konfiguration darf nur Standortdimensionen enthalten. Diese Konfiguration gilt für alle dienstspezifischen Dimensionen, mit Ausnahme der explizit mit Methode 1 konfigurierten Dimensionen.
Die Konfiguration darf nur dienstspezifische Dimensionen enthalten. Diese Konfiguration gilt für alle Standorte mit Ausnahme der Standorte, die explizit mit Methode 1 oder 2 konfiguriert wurden.
Wenn die Konfiguration beliebige dienstspezifische Dimensionen enthält, muss sie alle dienstspezifischen Dimensionen enthalten.
Sie können Konfigurationen ohne Dimensionen haben. Solche Konfigurationen gelten für alle Standorte und alle dienstspezifischen Dimensionen, mit Ausnahme der explizit konfigurierten.