Kontingentfehler beheben

Es kann verschiedene Gründe für Kontingentfehler geben, z. B. das Überschreiten von Kontingentwerten oder das falsche Festlegen des Kontingents für ein Projekt. Wenn Sie benachrichtigt werden möchten wenn Fehler 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, Google Cloud gibt einen Fehler zurück, je nachdem, wie Sie auf den Dienst zugegriffen haben:

  • Wenn Sie mit einer API-Anfrage ein Kontingent überschreiten, Google Cloud gibt den HTTP 413 REQUEST ENTITY TOO LARGE Statuscode 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. 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, Google Cloud gibt den HTTP 429 TOO MANY REQUESTS Statuscode zurück.
  • Wenn Sie ein Kontingent für die Compute Engine überschreiten, Google Cloud gibt in der Regel den HTTP 403 QUOTA_EXCEEDED Statuscode zurück, unabhängig davon, ob die Anfrage über die API, HTTP/REST, oder gRPC erfolgt ist. Wenn das Kontingent ein Ratenkontingent ist, wird 403 RATE_LIMIT_EXCEEDED zurückgegeben.
  • Wenn Sie mit gRPC ein Kontingent überschritten haben, Google Cloud gibt 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 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 der Meldung QUOTA_EXCEEDED.

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

  • Wenn Sie Diagramme mit der aktuellen und der Spitzenlast sehen möchten, rufen Sie in der Google Cloud Console die Seite IAM und Verwaltung> 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 anfordern.

Projektkontingent überschreiten

Weitere Informationen zum Anfordern zusätzlicher Projektkontingente finden Sie im Supportartikel Anfragen zu Projektkontingenten.

API-Fehlermeldungen

Wenn Ihr Kontingentprojekt (auch Abrechnungsprojekt genannt) nicht richtig festgelegt ist, geben API-Anfragen möglicherweise Fehlermeldungen zurück, die den folgenden ähneln:

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

Diese und andere Fehler lassen sich oft beheben, indem Sie das Kontingentprojekt festlegen. Weitere Informationen finden Sie unter Kontingentprojekte – Übersicht.

Google Cloud CLI-Fehler

In diesem Abschnitt werden häufige Probleme beschrieben, die beim Einstieg in die Google Cloud CLI (gcloud CLI) auftreten.

Installieren und initialisieren

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

  1. Installieren Sie die gcloud CLI.

    Wenn Sie Cloud Shell verwenden, können Sie diesen Schritt überspringen, da die gcloud CLI vorinstalliert ist.

  2. Initialisieren Sie die gcloud CLI.

  3. Installieren Sie die Beta-Komponente mit dem folgenden Befehl:

    gcloud components install beta

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.

Um dieses Problem zu beheben, fügen Sie dem gcloud CLI-Befehl das Flag --billing-project 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:

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 quotas Befehlen und Flags finden Sie in der Google Cloud CLI-Referenz im Abschnitt.

Nächste Schritte