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.

Google Cloud CLI-Fehler

In diesem Abschnitt werden häufige Probleme beschrieben, die bei den ersten Schritten mit der Google Cloud CLI (gcloud CLI) auftreten können.

Installieren und initialisieren

Wenn Sie die gcloud CLI für Cloud-Kontingente verwenden möchten, müssen Sie die folgenden Komponenten installieren und initialisieren:

Installieren Sie die gcloud CLI.

Wenn Sie Cloud Shell verwenden, können Sie diesen Schritt überspringen, da die gcloud CLI vorinstalliert ist.
Initialisieren Sie die gcloud CLI.
Installieren Sie die Alpha-Komponente mit dem folgenden Befehl:
```
gcloud components install alpha
```

Kontingentprojekt festlegen

Wenn Sie Ihr Kontingentprojekt nicht festgelegt haben, geben gcloud CLI-Befehle 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:

Kontingentprojekt programmatisch festlegen
Legen Sie das Abrechnungsprojekt über die gcloud CLI fest.

gcloud CLI-Komponenten aktualisieren

Wenn Sie die Fehlermeldung erhalten, dass der Befehl „Kontingente“ ein Invalid choice enthält, ist möglicherweise eine ältere Version der gcloud CLI installiert. Aktualisieren Sie die gcloud CLI-Komponenten mit dem folgenden Befehl.

gcloud components update

Weitere Informationen zu gcloud alpha quotas-Befehlen und Flags finden Sie in der Google Cloud CLI-Referenz im Abschnitt gcloud Alpha – Kontingente.