Kontingente aufrufen und verwalten

Auf dieser Seite wird beschrieben, wie Sie Kontingentwerte sowohl in der Google Cloud Console als auch im API-Dashboard aufrufen können. Sie können Kontingente auch über die Google Cloud Console, die Google Cloud CLI und die Service Usage API verwalten.

Kontingente in der Google Cloud Console ansehen

Ihre aktuellen Kontingentwerte können Sie in zwei verschiedenen Bereichen der Google Cloud Console einsehen:

  • Auf der Seite Kontingente sind alle Kontingentnutzungen und -werte für Ihr Projekt aufgelistet.
  • Das Google Cloud Console API-Dashboard, das Kontingentinformationen für eine bestimmte API auflistet, einschließlich der Ressourcennutzung in einem bestimmten Zeitraum.

Kontingente für Ihr Projekt ansehen

Führen Sie die folgenden Schritte aus, um die Kontingentnutzung und -limits für alle Ressourcen in Ihrem Projekt anzusehen:

  1. Öffnen Sie in der Google Cloud Console die Seite Kontingente.

    Kontingente aufrufen

    Die verbleibenden Schritte werden automatisch in der Google Cloud Console angezeigt.

  2. Wenn Sie sich auf die benötigten Informationen konzentrieren möchten, können Sie die Liste so filtern und sortieren:

    • Geben Sie zum Filtern der Liste die gewünschten Attribute und Werte in das Feld Filter ein. Wenn Sie beispielsweise die BigQuery API-Kontingente aufrufen möchten, wählen Sie Dienst und dann BigQuery API aus.
    • Zum Sortieren der Liste klicken Sie auf die Überschrift der Spalte, nach der Sie sortieren möchten. Wenn Sie beispielsweise alphabetisch nach dem Kontingentnamen sortieren möchten, klicken Sie auf die Spaltenüberschrift Kontingent.

      Standardmäßig werden die am häufigsten verwendeten Kontingente in der Liste sortiert. So können Sie leicht feststellen, bei welchen Limits die Gefahr besteht, dass sie überschritten werden.

Die Seite Kontingente zeigt eine Tabelle mit konfigurierbaren Spalten an. Die Spalten Dienst und Kontingent enthalten allgemeine Informationen dazu, welches Kontingent beschrieben wird. Beispiel: Der Dienst könnte Folgendes sein: Cloud Logging API und die Kontingente könnten Folgendes sein: Anfragen für Logaufnahme pro Minute. Im Feld Kontingent wird auch beschrieben, wie das Kontingent ausgewertet wird. Ratenkontingente werden pro Minute, pro 100 Sekunden oder pro Tag ausgewertet. Kontingente ohne diese Angaben sind Zuordnungskontingente.

Weitere Informationen zum Kontingent finden Sie in den Spalten Messwert, Bezeichnung des Limits und Überwachte Ressource. Diese Spalten enthalten detaillierte Informationen zum Diagramm eines Kontingents.

Informationen zur Kontingentnutzung finden Sie in den Spalten Aktuelle Nutzung in Prozent und Aktuelle Nutzung. Die aktuelle Nutzung wird anhand der folgenden Kriterien berechnet:

  • Für Ratenkontingente pro Minute gilt:

    • Die durchschnittliche Nutzung pro Minute in den letzten 10 Minuten.
  • Für Ratenkontingente pro Tag gilt:

    • Die bisherige gesamte Nutzung am aktuellen Tag gemäß der Pacific Standard Time.
  • Für Zuweisungskontingente gilt:

    • Der aktuellste Wert. Diese Zahl kann beispielsweise die Anzahl der Load-Balancer enthalten, die derzeit von Ihrem Projekt verwendet werden.
  • Für gleichzeitige Kontingente:

    • Der aktuellste Wert. Diese Zahl kann beispielsweise die Anzahl der derzeit ausgeführten Einfügevorgänge für einen bestimmten Dienst anzeigen.

Wenn Sie ein Nutzungsdiagramm aufrufen möchten, klicken Sie ganz rechts in der Spalte auf das Diagrammsymbol.

Weitere Informationen zu Kontingenten für einen bestimmten Dienst finden Sie in der Dokumentation zu diesem Dienst. Das Compute Engine-Kontingent ist beispielsweise unter Ressourcenkontingente dokumentiert.

API-spezifische Kontingente aufrufen

Weitere Details zu Kontingenten für eine bestimmte API, einschließlich der laufenden Nutzung, finden Sie in der Google Cloud Console auf der Kontingentseite für die API. Je nach der API können diese Limits Anfragen pro Tag, Anfragen pro Minute und Anfragen pro Minute pro Nutzer umfassen. Für einige APIs gelten sehr niedrige Limits, bis Sie die Abrechnung für Ihr Projekt aktivieren.

Sie können sich die aktuellen Limits für eine bestimmte API in zwei verschiedenen Bereichen der Google Cloud Console ansehen:

  • Auf der Seite „Kontingente” der Google Cloud Console.

  • Auf der Dashboard-Seite „APIs & Dienste” der Google Cloud Console. Wählen Sie auf dieser Seite Ihr Projekt aus, klicken Sie auf den API-Namen und dann auf Kontingente. Auf der Seite Kontingente werden die Kontingentnamen für die API angezeigt. Sie können für jedes Kontingent auf das Symbol Nutzungsdiagramm anzeigen klicken, um die detaillierte Nutzung im Zeitverlauf anzusehen. Standardmäßig werden die angezeigten Limits von Google festgelegt. Sie können die Nutzung einschränken, wie im Abschnitt Nutzung einschränken beschrieben. Wenn für ein bestimmtes Kontingent kein von Google festgelegter Wert vorhanden ist, wird der Wert als Unbegrenzt angezeigt.

Kontingente über die Google Cloud Console verwalten

Abhängig von Ihrer Ressourcennutzung möchten Sie die Kontingentwerte Ihres Projekts unter Umständen erhöhen oder herabsetzen. In diesem Abschnitt wird beschrieben, wie Sie die angegebenen Kontingentwerte ändern können. Klicken Sie in der Spalte Details auf Alle Kontingente, um die Werte aufzurufen.

Kontingente filtern

So filtern Sie die Liste der Kontingente nach bestimmten Attributen:

  1. Rufen Sie in der Google Cloud Console die Seite Kontingente auf.

    Kontingente aufrufen

  2. Klicken Sie auf Filter, um Ihr Kontingent anhand eines bestimmten Attributs abzufragen.

Höheres Kontingent anfordern

So fordern Sie über die Google Cloud Console einen höheren Kontingentwert an:

  1. Rufen Sie die Seite Kontingente auf:

    Kontingente aufrufen

    Die verbleibenden Schritte werden automatisch in der Google Cloud Console angezeigt.

  2. Suchen Sie auf der Seite Kontingente in der Spalte Kontingent nach dem Kontingent, das Sie erhöhen möchten.

    Über das Suchfeld Filter können Sie nach Ihrem Kontingent suchen.

  3. Klicken Sie das Kästchen links neben Ihrem Kontingent an.

  4. Klicken Sie auf KONTINGENTE BEARBEITEN. Das Formular Kontingentänderungen wird angezeigt.

  5. Geben Sie im Formular Kontingentänderungen in das Feld Neues Limit das gewünschte Kontingent für Ihr Projekt ein.

  6. Füllen Sie die zusätzlichen Felder im Formular aus und klicken Sie dann auf FERTIG.

  7. Klicken Sie auf Anfrage senden.

Obwohl das vorherige Verfahren für die meisten Anfragen zur Kontingenterhöhung gilt, kann eine der folgenden Ausnahmen auftreten:

  • Wenn für das Kontingent eine Nutzungsobergrenze vorhanden ist, muss die Nutzungsobergrenze entfernt werden, bevor das Kontingent erhöht werden kann. Sie erhalten eine Offenlegung und eine Vereinbarung. In der Offenlegung wird angegeben, dass die Nutzungsbeschränkung gelöscht und das Limit sofort auf das Standardlimit aktualisiert wird. Ihre Kontingenterhöhungsanfrage wird dann normal von Google Cloud verarbeitet.
  • In manchen Fällen werden Sie von der Google Cloud Console zu einem separaten Formular weitergeleitet, um ein höheres Limit anzufordern. Nachdem Sie das Formular gesendet haben, bestätigt Google Cloud Ihre Anfrage per E-Mail.
  • Einige Kontingente können nicht über die Google Cloud Console aktualisiert werden. Wenn Sie feststellen, dass Sie ein Kontingent nicht über die Console ändern können, fordern Sie eine Erhöhung über Cloud Customer Care an. Das Abrechnungsteam bearbeitet keine Kontingenterhöhungen.

Google empfiehlt, für jede Ressourcenklasse eine eigene Anfrage zur Kontingenterhöhung zu erstellen. Beispielsweise sollten Sie die Netzwerk-Kontingenterhöhungen pro Projekt von den Compute Engine-Kontingenterhöhungen ohne Netzwerk trennen. Wenn verschiedene Klassen von Anfragen kombiniert werden, kann eine Erhöhungsanfrage den Batch verzögern, wenn ihre Genehmigung mehr Bewertungszeit erfordert.

Wenn Ihre Anfrage zur Kontingenterhöhung Genehmigung erfordert, können Sie erwarten, eine E-Mail von Google Cloud mit einer Empfangsbestätigung zu erhalten. Wenn Sie weitere Hilfe benötigen, können Sie auf diese E-Mail antworten. Cloud Customer Care bearbeitet Ihre Anfrage in der Regel innerhalb von zwei bis drei Arbeitstagen. Cloud Customer Care sendet Ihnen dann eine zweite E-Mail, in der Sie darüber informiert werden, ob die Kontingenterhöhung genehmigt oder abgelehnt wurde. Die E-Mail gibt gegebenenfalls das Datum des Inkrafttretens der Erhöhung an.

Weitere Informationen zur Funktionsweise der Kontingenterhöhung finden Sie unter Anfragen zur Kontingenterhöhung.

Anfragen zur Kontingenterhöhung ansehen

Sie können derzeit ausstehende und vergangene Kontingenterhöhungsanfragen in der Google Cloud Console sehen.

So zeigen Sie ausstehende Anfragen zur Kontingenterhöhung an:

  1. Prüfen Sie, ob Sie die Berechtigung zum Ansehen von Kontingenterhöhungsanfragen haben.

  2. Rufen Sie die Seite Kontingente auf:

    Kontingente aufrufen

  3. Auf der Seite Kontingente wird neben den Kontingentwerten, die derzeit auf eine Entscheidung für zuvor gesendete Erhöhungsanfragen warten, Ausstehend angezeigt. Sie können auf Ausstehend klicken, um Details zu den ausstehenden Anfragen anzuzeigen.

Ausstehende Anfragen werden auch im Formular Kontingentänderungen angezeigt, wenn eine neue Kontingenterhöhung angefordert wird.

So zeigen Sie alle Kontingenterhöhungsanfragen an (derzeit ausstehende und vergangene Anfragen):

  1. Rufen Sie die Seite Kontingente auf:

    Kontingente aufrufen

  2. Klicken Sie auf den Tab Anfragen erhöhen.

  3. Klicken Sie auf Filter um Ihre Kontingenterhöhungsanfragen nach einem bestimmten Attribut abzufragen.

Ist eine Organisation oder ein Ordner ausgewählt, werden auf der Seite alle Anfragen zur Kontingenterhöhung für alle Projekte unter der Organisation oder dem Ordner angezeigt.

Nutzung begrenzen

Möglicherweise möchten Sie die Nutzung einer bestimmten Ressource einschränken, indem Sie ein eigenes Kontingentlimit festlegen. Wenn Sie beispielsweise verhindern möchten, dass Ihnen Anfragen berechnet werden, die das Limit für die kostenlose Nutzung überschreiten, können Sie eine Obergrenze für die Anfragen pro Tag anfordern.

Führen Sie die gleichen Schritte wie unter Höheres Kontingentlimit anfordern aus, um ein Kontingent zu begrenzen.

Die Einschränkung der Nutzung mit Kontingenten gilt nicht für alle Dienste. Weitere Informationen finden Sie auf der Seite zu den Kontingenten für Ihren Dienst.

Kontingente über das Google Cloud CLI verwalten

Mit dem Google Cloud CLI können Sie aktuelle Kontingente abrufen und die Nutzung für einige Google Cloud APIs und -Dienste beschränken. Mögliche Bereiche sind Kontingente auf Project-, Ordner- oder Organisationsebene, sofern verfügbar.

Für diesen Ansatz müssen Sie zuerst die neueste Version des Google Cloud CLI installiert und initialisiert haben, einschließlich der Alphabefehle. Wenn Sie Cloud Shell für die Interaktion mit Google Cloud verwenden, wird das Google Cloud CLI für Sie installiert.

Führen Sie folgenden Befehl aus und setzen Sie dabei Ihre Projekt-ID und den Dienstnamen ein, um das Kontingent für einen bestimmten Dienst anzuzeigen:

gcloud alpha services quota list \
   --service=SERVICE_NAME.googleapis.com \
   --consumer=projects/PROJECT_ID

So rufen Sie die Kontingentdetails desselben Dienstes für eine Organisation auf:

gcloud alpha services quota list \
   --service=SERVICE_NAME.googleapis.com \
   --consumer=organizations/ORG_ID

Eine vollständige Liste der gcloud quota-Befehle und Flags finden Sie in der Referenz zum Google Cloud CLI.

Zusätzlich zu gcloud quota haben einige Dienste einen eigenen Befehlszeilenzugriff auf Informationen zu Kontingenten und zur Ressourcennutzung. In Compute Engine können Sie beispielsweise mithilfe von gcloud compute auf Kontingentinformationen zugreifen.

Kontingente über die Service Usage API verwalten

Mit den Service Usage APIs können Sie aktuelle Kontingente abrufen und die Kontingentnutzung für einige Google Cloud APIs und -Dienste beschränken. Weitere Informationen zu Service Usage finden Sie hier:

Sie können die Service Usage API allerdings nicht nutzen, um ein höheres Kontingent anzufordern. Dazu müssen Sie die Google Cloud Console verwenden.