Kontingentfehler beheben

Kontingentfehler können verschiedene Gründe haben, z. B. eine Überschreitung von Kontingentwerten oder eine falsche Einstellung des Kontingentprojekts. Wenn Sie benachrichtigt werden möchten, wenn Fehler in Zukunft auftreten, können Sie benutzerdefinierte Benachrichtigungen für bestimmte Kontingentfehler erstellen, wie unter Kontingentbenachrichtigungen einrichten beschrieben.

Ratenkontingente überschreiten

Ratenkontingente werden nach einem vordefinierten Zeitintervall zurückgesetzt, das für jeden Dienst spezifisch ist. Weitere Informationen finden Sie in der Dokumentation zu Kontingenten für den jeweiligen Dienst.

Kontingentwerte überschreiten

Wenn Ihr Projekt bei der Nutzung eines Dienstes den maximalen Kontingentwert überschreitet, gibt Google Cloud einen Fehler basierend darauf zurück, wie Sie auf den Dienst zugegriffen haben:

Wenn Sie mit einer API-Anfrage ein Kontingent überschreiten, gibt Google Cloud den HTTP-Statuscode 413 REQUEST ENTITY TOO LARGE zurück. Wenn Sie die Legacy-Streaming-API von BigQuery in einer Produktionsumgebung verwenden, erhalten Sie möglicherweise den Statuscode 413 REQUEST ENTITY TOO LARGE, wenn Ihre HTTP-Anfragen größer als 10 MB sind. Dieser Fehler kann auch auftreten, wenn Sie 300 MB pro Sekunde überschreiten. Weitere Informationen finden Sie unter Streaming-Insert-Anweisungen.
Wenn Sie mit einer HTTP/REST-Anfrage ein Kontingent überschritten haben, gibt Google Cloud den HTTP-Statuscode 429 TOO MANY REQUESTS zurück.
Wenn Sie ein Kontingent für Compute Engine überschreiten, gibt Google Cloud normalerweise einen HTTP-Statuscode 403 QUOTA_EXCEEDED zurück, unabhängig davon, ob er von der API, HTTP/REST oder gRPC stammt. Wenn das Kontingent ein Ratenkontingent ist, wird 403 RATE_LIMIT_EXCEEDED zurückgegeben.
Wenn Sie mit gRPC ein Kontingent überschritten haben, gibt Google Cloud einen ResourceExhausted-Fehler zurück. Wie dieser Fehler angezeigt wird, hängt vom Dienst ab.
Wenn Sie mit einem Google Cloud CLI-Befehl ein Kontingent überschritten haben, gibt die gcloud CLI eine Fehlermeldung über das Kontingent aus und liefert den Exit-Code 1.
Wenn Sie während eines Dienst-Rollouts eine QUOTA_EXCEEDED-Nachricht erhalten haben, lesen Sie den folgenden Abschnitt.

Kontingentwerte während eines Dienst-Roll-outs überschreiten

Google Cloud ändert manchmal die Standardwerte für Kontingente für Ressourcen und APIs. Diese Änderungen werden schrittweise vorgenommen. Das bedeutet, dass der Kontingentwert, der in der Google Cloud Console angezeigt wird, während der Einführung eines neuen Standardkontingents möglicherweise nicht dem neuen Kontingentwert entspricht, der Ihnen zur Verfügung steht.

Wenn ein Kontingent-Roll-out läuft, erhalten Sie möglicherweise eine Fehlermeldung mit der Meldung The future limit is the new default quota that will be available after a service rollout completes.. Wenn diese Fehlermeldung angezeigt wird, sind der angegebene Kontingentwert und der zukünftige Wert korrekt, auch wenn sich die Angabe in der Google Cloud Console unterscheidet.

Weitere Informationen finden Sie in den Audit-Logs. Suchen Sie dann nach einer QUOTA_EXCEEDED-Nachricht.

    "status": {
      ...
      "message": "QUOTA_EXCEEDED",
      "details": [
        {
          ...
          "value": {
            "quotaExceeded": {
              ...
              "futureLimit": FUTUREVALUE
            }
          }
        }
      ]
    },

Klicken Sie in der Google Cloud Console auf das Monitoring-Symbol monitoring, um Diagramme mit der aktuellen und der Spitzennutzung aufzurufen. Möglicherweise müssen Sie ganz nach rechts scrollen, um dieses Symbol zu sehen.
Wenn Sie ein größeres Kontingent benötigen, als Sie Zugriff haben, und nicht warten können, bis der Dienst-Rollout abgeschlossen ist, fordern Sie eine Kontingentanpassung an.

API-Fehlermeldungen

Wenn Ihr Kontingentprojekt (auch als Abrechnungsprojekt bezeichnet) nicht richtig festgelegt ist, geben API-Anfragen die folgenden Fehlermeldungen zurück:

user credentials not supported by this API
API not enabled in the project
- no quota project set

Diese und andere Fehler können häufig durch Festlegen des Kontingentprojekts behoben werden. Weitere Informationen finden Sie unter Kontingentprojekte – Übersicht.