Laufende Roll-outs ansehen

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:

  1. Rufen Sie in der Console die Seite „Cloud-Kontingente“ auf.

    Kontingente und Systemlimits aufrufen

  2. Klicken Sie in der Nachricht auf den Link Kontingente. Dadurch wird der Filter: Hat laufendes Roll-out: Wahr aktiviert.

  3. 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 Feld rollout_info in der Antwort unter QuotaDetails 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 jeder dimensionsInfo-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:

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 Feld rolloutInfo 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 Feld rolloutInfo 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" ]
}]