Kontingentfehler beheben

Es kann verschiedene Gründe für Kontingentfehler geben, z. B. das Überschreiten von Kontingentwerten oder eine falsche Kontingenteinstellung für ein Projekt. Wenn Sie benachrichtigt werden möchten, wenn Fehler auftreten, können Sie benutzerdefinierte Benachrichtigungen für bestimmte Kontingentfehler erstellen, wie in 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 das maximale Kontingent ü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 BigQuery Legacy Streaming API 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. Möglicherweise wird dieser Fehler auch angezeigt, 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 die Compute Engine überschreiten, gibt Google Cloud in der Regel den HTTP-Statuscode 403 QUOTA_EXCEEDED zurück, unabhängig davon, ob die Anfrage über die API, HTTP/REST oder gRPC erfolgt. Wenn es sich um ein Preiskontingent handelt, 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-Roll-outs die Meldung QUOTA_EXCEEDED 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 dort nach einer QUOTA_EXCEEDED-Nachricht.

        "status": {
          ...
          "message": "QUOTA_EXCEEDED",
          "details": [
            {
              ...
              "value": {
                "quotaExceeded": {
                  ...
                  "futureLimit": FUTUREVALUE
                }
              }
            }
          ]
        },
    
  • Wenn Sie Diagramme mit der aktuellen und der Spitzennutzung aufrufen möchten, rufen Sie die Seite Kontingente und Systemlimits auf und klicken Sie dann auf Monitoring. Möglicherweise müssen Sie zum Ende der Tabelle scrollen.

  • Wenn Sie mehr Kontingent benötigen, können Sie eine Kontingentanpassung beantragen.

API-Fehlermeldungen

Wenn Ihr Kontingentprojekt (auch Abrechnungsprojekt genannt) nicht richtig festgelegt ist, werden bei API-Anfragen möglicherweise Fehlermeldungen wie die folgenden zurückgegeben:

  • User credentials not supported by this API
  • API not enabled in the project
  • No quota project set

Diese und andere Fehler lassen sich oft durch das Festlegen des Kontingentprojekts beheben. Weitere Informationen finden Sie unter Kontingentprojekte – Übersicht.

gcloud CLI-Fehler

Wenn Sie Ihr Kontingentprojekt nicht festgelegt haben, geben Google Cloud CLI-Befehle (gcloud CLI) möglicherweise einen Fehler wie den folgenden zurück:

PERMISSION_DENIED: Your application is authenticating by using local Application Default Credentials.
The cloudquotas.googleapis.com API requires a quota project, which is not set by default.

Fügen Sie zum Beheben dieses Problems das Flag --billing-project zu Ihrem gcloud CLI-Befehl hinzu, um das Kontingentprojekt explizit festzulegen, oder führen Sie gcloud config set billing/quota_project CURRENT_PROJECT noch einmal aus, um das Kontingentprojekt als aktuelles Projekt festzulegen.

Hier finden Sie weitere Informationen: