Mit Cloud-Kontingenten können Sie laufende Roll-outs von Kontingentwerten aufrufen. In diesem Abschnitt wird erläutert, wie Sie diese Roll-outs über die Google Cloud Console und die Cloud Quotas API aufrufen.
Informationen zu laufenden Roll-outs
Wenn ein anderer Google Cloud-Dienst die Standardkontingentwerte für Ressourcen und APIs erhöht, werden diese Änderungen schrittweise umgesetzt. Dies kann zu laufenden Roll-outs in verschiedenen Regionen oder Ressourcen führen. Während des Roll-outs spiegelt der Kontingentwert, der in der Google Cloud Console oder der Cloud Quotas API angezeigt wird, nicht den neuen, erhöhten Kontingentwert wider, bis der Roll-out abgeschlossen ist.
Aktuelle Roll-outs über die Console ansehen
Bei laufenden Kontingent-Roll-outs wird eine Informationsmeldung oben auf der Seite „Cloud-Kontingente“ in der Console angezeigt. Die Nachricht erscheint ähnlich wie der folgende Text, der ebenfalls einen Link enthält. Klicken Sie auf Kontingente, um zu filtern, sodass nur Kontingente mit laufende Roll-outs angezeigt werden:
Values for quotas are being updated. This may take 2-3 weeks to complete.
Die Anzeige Rolling Update aktualisieren wird neben den Kontingentwerten angezeigt, die von laufenden Roll-outs betroffen sind.
Wenn Sie die Anzeige Rolling Update aktualisieren nicht sehen, führen Sie die folgenden Schritte aus:
Rufen Sie in der Console die Seite „Cloud-Kontingente“ auf.
Klicken Sie in der Nachricht auf den Link Kontingente. Dadurch wird der Filter: Hat laufendes Roll-out: Wahr aktiviert.
Die Tabelle wird aktualisiert und zeigt nun eine Anzeige Rolling Update aktualisieren neben Kontingentwerten mit laufenden Roll-outs.
Die Anzeige Rolling Update wird auch im Bereich Kontingente bearbeiten und Diagramm zur Kontingentnutzung überwachen zur Identifizierung von Kontingenten bei laufenden Roll-outs angezeigt.
Aktuelle Roll-outs über die Cloud Quotas API ansehen
Sie können laufende Roll-outs auch mithilfe der Cloud Quotas API aufrufen. Weitere Informationen finden Sie in der Anleitung zum Einrichten der Cloud Quotas API und in häufige Anwendungsfälle implementieren.
Das Ressourcenmodell der Cloud Quotas API verwendet die QuotaInfo
- und QuotaPreference
-Ressourcen, um laufende Roll-outs anzuzeigen:
Die Ressource
QuotaInfo
gibt bei laufenden Roll-outs den vorherigen Kontingentwert zurück. Für Kontingente, die gerade eingeführt werden, wird das Feldrollout_info
in der Antwort unterQuotaDetails
angezeigt. Dieses Feld gibt an, dass es sowohl ein laufendes Roll-out als auch eine Erhöhung des Kontingentwerts für die Dimensionen gibt, die in jederdimensionsInfo
-Ressource angegeben sind.Die Ressource
QuotaPreference
gibt während des laufenden Roll-outs den vorherigen Kontingentwert zurück.
Bei laufenden Roll-outs geben die folgenden Cloud Quotas APIs den vorherigen Kontingentwert zurück:
Vor der Verwendung der Cloud Quotas API
In den folgenden Abschnitten wird davon ausgegangen, dass Sie mit der Cloud Quotas API vertraut sind. Prüfen Sie vor der Verwendung der Cloud Quotas API dass Sie Ihre Entwicklungsumgebung eingerichtet haben und mit den Befehlen für GET-Anfragen nach Kontingentinformationen vertraut sind:
- Einen Überblick erhalten Sie unter Übersicht über die Cloud Quotas API
- Eine Anleitung zum Einrichten der Entwicklungsumgebung finden Sie unter Anleitung zum Einrichten der Cloud Quotas API
- Ein Beispiel für eine API-Anfrage und -Antwort finden Sie im Beispiel für Kontingentinformationen für eine dienstspezifische Dimension abrufen
Beispiel für eine API-Antwort während eines laufenden Roll-outs
Das folgende Beispiel zeigt die Ergebnisse eines regionalen Kontingents, das in vier Regionen unterstützt wird: us-central1, us-central2, us-west1, us-east1. Der Standardwert ist 200 in us-central1 und 100 in allen anderen Regionen. Dieses regionale Kontingent hat auch eine zusätzliche Kontingentüberschreibung von 300 in us-central2.
Angenommen, der Dienstersteller aktualisiert den Standardwert in us-central1 und us-central2 auf 220
. Das folgende Beispiel zeigt eine QuotaInfo-Antwort, bei der der Roll-out der Dienstkonfiguration für us-central1 und us-central2 läuft:
- Im Feld
details
wird für jeden Standort der Kontingentwert angezeigt, bevor der Roll-out abgeschlossen ist. - Für us-central1 beträgt der Kontingentwert
200
und das FeldrolloutInfo
gibt an, dass ein laufender Roll-out läuft. Der Kontingentwert ändert sich erst nach Abschluss des Roll-outs auf 220. - Für us-central2 beträgt der Kontingentwert aufgrund der Kontingentüberschreibung
300
. Das FeldrolloutInfo
wird nicht angezeigt, da der Kontingentwert nach Abschluss des Roll-outs beibehalten wird. - Sowohl für us-west1 als auch für us-east1 ist der Wert standardmäßig
100
.
"name": "projects/PROJECT_NUMBER/locations/global/services/compute.googleapis.com/quotaInfos/GPUS-PER-GPU-FAMILY-per-project-region", "quotatId": "GPUS-PER-GPU-FAMILY-per-project-region", "metric": "compute.googleapis.com/gpus_per_gpu_family", "service": "compute.googleapis.com", "isPrecise": true, "containerType": "PROJECT", "dimensions": [ "gpu_family", "region" ], "quotaDisplayName": "GPUs per GPU family", "metricDisplayName": "GPUs", "dimensionsInfos": [ { "dimensions": { "region" : "us-central1" } , "details": { "value": 200, "rolloutInfo": { "ongoingRollout": true } }, "applicableLocations": [ "us-central1" ] , }, { "dimensions": { "region" : "us-central2" } , "details": { "value": 300, }, "applicableLocations": [ "us-central2" ] }, { "dimensions": {}, "details": { "value": 100, }, "applicableLocations": [ "us-west1", "us-east1" ] }]