Kontingente aufrufen und verwalten

In diesem Dokument wird beschrieben, wie Sie Kontingentwerte in derGoogle Cloud Console aufrufen können. Sie können Kontingente auch über dieGoogle Cloud Console, die Cloud Quotas API und die Google Cloud CLI (gcloud CLI) verwalten.

Beschränkungen

Für Cloud-Kontingente gelten die folgenden Einschränkungen:

  • In den meisten Fällen müssen Anpassungen der Kontingenterhöhung auf Projektebene vorgenommen werden. Eine begrenzte Anzahl von Produkten unterstützt Anpassungen zur Kontingenterhöhung auf Organisationsebene. Ob ein Google Cloud Produkt Anpassungen von Kontingenterhöhungen auf Organisationsebene unterstützt, erfahren Sie in der Dokumentation zu diesem Produkt.

  • Sie können eine Verringerung der Kontingente für Kontingente auf Projekt-, Organisations- und Ordner-Ebene anfordern.

Hinweise

Für die Aufgaben in diesem Dokument sind IAM-Rollen (Identity and Access Management) erforderlich.

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Anfordern von Kontingentanpassungen benötigen, bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt, den Ordner oder die Organisation zuzuweisen:

  • So rufen Sie Kontingente auf: Quota Viewer (roles/servicemanagement.quotaViewer)
  • So beantragen Sie Kontingentanpassungen: Quota Administrator (roles/servicemanagement.quotaAdmin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Anfordern von Kontingentanpassungen erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Kontingenterhöhungen zu beantragen:

  • So fordern Sie Kontingentanpassungen an: serviceusage.quotas.update

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Kontingente in der Google Cloud Console ansehen

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

Kontingente für Ihr Projekt ansehen

Auf der Seite IAM & Verwaltung > Kontingente und Systemlimits wird eine Tabelle mit konfigurierbaren Spalten angezeigt. Die Spalten Dienst und Kontingent enthalten allgemeine Informationen dazu, welches Kontingent beschrieben wird. Beispiel: Der Dienst könnte Cloud Logging API sein und das Kontingent Anfragen für Logaufnahme pro Minute. Im Feld Quota 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.

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

Console

  1. Gehen Sie in der Google Cloud Console zu IAM und Verwaltung > Kontingente und Systemlimits:

    Zur Seite „Kontingente und Systemlimits“

  2. Filtern und sortieren Sie die Liste so, damit nur die benötigten Informationen angezeigt werden:

    • Geben Sie zum Filtern der Liste die gewünschten Attribute und Werte in das Feld ein. Wenn Sie beispielsweise die BigQuery API-Kontingente ansehen 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 ist die Liste nach den am häufigsten verwendeten Kontingenten sortiert. So können Sie leicht feststellen, bei welchen Kontingenten die Gefahr besteht, dass sie überschritten werden.

  3. Optional: Um die Kontingentnutzung auf Ordner- und Organisationsebene zusammenzufassen, wählen Sie die Organisation oder den Ordner aus dem Ressourcen-Selektor aus.

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 letzte Wert. Diese Zahl kann beispielsweise die Anzahl der Load-Balancer enthalten, die derzeit von Ihrem Projekt verwendet werden.

  • Für gleichzeitige Kontingente:

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

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.

Kontingentnutzung im Zeitverlauf ansehen und exportieren

Sie können die Kontingentnutzung im Zeitverlauf in Diagrammen ansehen. Auf der Seite „Kontingente und Systemlimits“ in der Konsole finden Sie Diagramme für jedes einzelne Kontingent oder Systemlimit in der Tabelle „Kontingente und Systemlimits“. Nachdem Sie sich ein Diagramm angesehen haben, können Sie es exportieren. So rufen Sie ein Diagramm auf und exportieren es:

Console

  1. Gehen Sie in der Google Cloud Console zu IAM und Verwaltung > Kontingente und Systemlimits:

    Zur Seite „Kontingente und Systemlimits“

  2. Suchen Sie nach dem gewünschten Kontingent oder Systemlimit. Klicken Sie im Eintrag für dieses Kontingent oder Systemlimit auf Nutzungsdiagramm einblenden. Die Diagrammansicht wird geöffnet.

  3. Legen Sie in der Diagrammansicht den Zeitraum fest. Der Standardwert ist 7 Tage. Wenn Sie das ändern möchten, klicken Sie auf das Menü für den Zeitraum und wählen Sie den gewünschten Zeitraum aus.

  4. Wenn Sie das Diagramm exportieren möchten, klicken Sie auf  Weitere Diagrammoptionen und wählen Sie dann Herunterladen > PNG herunterladen aus. Das Diagramm wird als PNG-Datei heruntergeladen.

Weitere Informationen zum Arbeiten mit Diagrammen finden Sie unter Kontingentbenachrichtigungen und ‑monitoring einrichten.

API-spezifische Kontingente aufrufen

Detaillierte Kontingentinformationen für eine bestimmte API, einschließlich der Nutzung im Zeitverlauf, finden Sie auf der Kontingentseite der API in der Google Cloud Console. 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.

Wenn für ein bestimmtes Kontingent kein Wert vorhanden ist, wird der Wert als Unlimited angezeigt.

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 und Systemlimits der Google Cloud Console oder auf der Seite APIs und Dienste. Verwenden Sie die Konsolenansicht, die Ihnen am besten gefällt:

Console

  • So rufen Sie API-spezifische Kontingente auf der Seite Kontingente und Systemlimits mit einem Filter auf:

    1. Gehen Sie in der Google Cloud Console zu IAM und Verwaltung > Kontingente und Systemlimits:

      Zur Seite „Kontingente und Systemlimits“

    2. Klicken Sie auf Filter und wählen Sie im angezeigten Menü Dienst aus.

    3. Wählen Sie den Dienstnamen aus, den Sie aufrufen möchten, oder geben Sie ihn ein.

      Auf der Seite werden Kontingente und Systemlimits für die angegebene API angezeigt. Die Zahlen in der Spalte Value sind die Standardkontingentwerte, sofern Sie keine Kontingentanpassung vorgenommen haben.

  • So rufen Sie API-spezifische Kontingente auf der Seite APIs & Dienste auf:

    1. Rufen Sie die Seite APIs & Dienste auf:

      Zu APIs & Dienste

    2. Wählen Sie Ihr Projekt aus.

    3. Klicken Sie auf den API-Namen des Dienstes, den Sie aufrufen möchten.

    4. Klicken Sie auf den Tab Kontingente und Systemlimits.

      Auf der Seite werden Kontingente und Systemlimits für die angegebene API angezeigt. Die Zahlen in der Spalte Value sind die Standardkontingentwerte, sofern Sie keine Kontingentanpassung vorgenommen haben.

Wenn Sie die Nutzung im Zeitverlauf sehen möchten, klicken Sie auf Nutzungsdiagramm einblenden.

Kontingente filtern

So filtern Sie die Liste der Kontingente nach bestimmten Attributen:

Console

  1. Gehen Sie in der Google Cloud Console zu IAM und Verwaltung > Kontingente und Systemlimits:

    Zur Seite „Kontingente und Systemlimits“

  2. Klicken Sie auf Filter, um Ihre Kontingente anhand eines bestimmten Attributnamens oder -werts abzufragen.

Kontingente über die Console verwalten

Je nach Ressourcennutzung möchten Sie die Kontingentwerte Ihres Projekts möglicherweise nach oben oder unten anpassen. In diesem Abschnitt wird beschrieben, wie Sie die bereitgestellte Kontingent-Werte ändern. Klicken Sie in der Spalte Details auf Alle Kontingente, um die Werte anzuzeigen.

Kontingentanpassung anfordern

Anfragen zur Anpassung von Cloud-Kontingenten unterliegen einer Prüfung. Wenn Ihre Anfrage zur Kontingentanpassung geprüft werden muss, erhalten Sie eine E‑Mail, in der der Eingang Ihrer Anfrage bestätigt wird. Falls Sie weitere Hilfe benötigen, antworten Sie einfach auf diese E‑Mail. Nach der Prüfung Ihrer Anfrage erhalten Sie eine E‑Mail-Benachrichtigung, in der Sie darüber informiert werden, ob Ihre Anfrage genehmigt wurde. Sie können eine Kontingentanpassung über die Google Cloud -Konsole, die Cloud Quotas API oder die Google Cloud CLI anfordern. In der folgenden Anleitung wird beschrieben, wie Sie einen neuen Kontingentwert über die Google Cloud -Konsole oder durch Senden einer REST-Anfrage an die Cloud Quotas API anfordern.

Console

So beantragen Sie eine Kontingentanpassung:

  1. Gehen Sie in der Google Cloud Console zu IAM und Verwaltung > Kontingente und Systemlimits:

    Zur Seite „Kontingente und Systemlimits“

    Wenn Sie aufgefordert werden, ein Projekt auszuwählen, wählen Sie das Projekt aus, das Sie anpassen möchten.

  2. Suchen Sie das Kontingent, das Sie anpassen möchten, und öffnen Sie das Dialogfeld Kontingentänderungen:

    • Nicht in der Tabelle enthaltene Kontingente:

      • Suchen Sie im Suchfeld Filter nach Ihrem Kontingent. Geben Sie die Region oder Zone (falls zutreffend) nicht an, da Kontingente ohne Nutzungs- oder angepasste Werte nicht in der Tabelle angezeigt werden.
      • Suchen Sie in der Tabelle nach Einträgen für Ihr Kontingent. Das kann der Standardeintrag oder ein beliebiger Eintrag mit Verlauf sein, unabhängig von Region oder Zone.
      • Klicken Sie in der Zeile des Eintrags auf  Weitere Aktionen > Zusätzliche Regionen/Zonen konfigurieren.
      • Wählen Sie die Region oder Zone aus, die Sie anpassen möchten. Klicken Sie auf Bearbeiten.

    • Alle anderen Kontingente:

      • Suchen Sie im Suchfeld Filter nach Ihrem Kontingent.
      • Klicken Sie in der Zeile für den Eintrag das Kästchen für Ihr Kontingent an.
      • Klicken Sie auf Bearbeiten.

    Das Dialogfeld Kontingentänderungen wird angezeigt.

  3. Wenn Sie über dem Feld Neuer Wert den Link Höheres Kontingent beantragen sehen und Ihr Kontingent über den auf dem Bildschirm angegebenen Wert hinaus erhöhen möchten, folgen Sie dem Link. Fülle das Formular aus, sende es ab und überspringe die restlichen Schritte. Andernfalls folgen Sie dieser Anleitung weiter.

  4. Geben Sie im Feld Neuer Wert den gewünschten erhöhten Kontingentwert ein. Wenn das Feld Beschreibung der Anfrage angezeigt wird, geben Sie eine Beschreibung ein. Klicken Sie auf Fertig.

    • Wenn Sie ein Kästchen mit dem Text „Ich bestätige, dass mit dieser Anfrage alle Überschreibungen entfernt werden“ sehen, ist Ihr Kontingentwert unter dem Standardwert festgelegt. Wenn Sie den Kontingentwert auf den Standardwert oder darüber hinaus anpassen, wird die Überschreibung entfernt. Setzen Sie ein Häkchen in das Kästchen, um fortzufahren. Weitere Informationen zu Kontingentüberschreibungen.

    Wenn die Schaltfläche Weiter angezeigt wird, klicken Sie auf Weiter und geben Sie auf dem nächsten Bildschirm Ihre Kontaktdaten ein.

  5. Klicken Sie auf Anfrage senden.

Wenn Sie feststellen, dass Sie eine Anpassung nicht über die Console beantragen können, fordern Sie die Erhöhung über Cloud Customer Care an.

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

Batchanfragen für Kontingentanpassungen

Sie können Anfragen zur Kontingentanpassung zusammenfassen, indem Sie das Kästchen für jedes Kontingent ankreuzen, das Sie einbeziehen möchten. Durch das Bündeln von Anfragen kann sich die Zeit verlängern, die Google Cloud für die Überprüfung Ihrer Anfrage benötigt.

Um die Überprüfungszeit zu verkürzen, sollten Sie Anfragen zur Kontingentanpassung nach Produkt und Bereich gruppieren. Wenn Sie beispielsweise Anpassungen für Netzwerk- und Compute Engine-VM-Kontingente anfordern möchten, erstellen Sie eine Anfrage für die Netzwerkkontingente und eine weitere Anfrage für die Compute Engine-VM-Kontingente.

REST

Mit dem folgenden Codebeispiel können Sie eine Kontingentanpassung über die Cloud Quotas API anfordern. Geben Sie Ihre Werte in die bearbeitbaren Platzhalter ein. Informationen zu den Platzhalterfeldern finden Sie in den Beschreibungen nach dem Codebeispiel.

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

Ersetzen Sie Folgendes:

  • PROJECT_NUMBER: Ihre Google Cloud Projektnummer. Sie finden Ihre Projektnummer auf der Willkommensseite der Google Cloud -Konsole oder durch Ausführen des folgenden gcloud CLI-Befehls:

    PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"

  • QUOTA_PREFERENCE_ID: Die ID der Kontingentpräferenz, die Sie aktualisieren.

  • QUOTA_ID: Die ID des Kontingents, das Sie aktualisieren.

  • SERVICE_ID: Die ID des Google Cloud , zu dem das anzupassende Kontingent gehört. Dieser hat in der Regel das Format SERVICE_NAME.googleapis.com. Der Compute Engine-Dienstname ist beispielsweise compute.googleapis.com.

  • DIMENSION_1: Der Typ der Dimension, die Sie anpassen möchten, z. B. region oder zone. Sie können mehrere Dimensionen einfügen. Trennen Sie die einzelnen Dimensionen durch ein Komma, z. B. VALUE_1. Wenn Sie alle Dimensionen des Kontingents anpassen möchten, lassen Sie diese Zeile weg.

  • VALUE_1: Der Wert der vorherigen Dimension. Wenn die vorhergehende Dimension beispielsweise region ist, geben Sie eine Region wie us-central1 ein.

  • JUSTIFICATION: Der Grund für diese Anfrage.

  • EMAIL: Eine E-Mail-Adresse, die als Kontakt verwendet werden kann, falls Google Cloud weitere Informationen benötigt, um eine Entscheidung zu treffen, bevor zusätzliches Kontingent gewährt werden kann.

Beispielanfrage

Das Folgende ist ein Beispiel für eine Anfrage zur Erhöhung des Kontingentwerts für das Compute Engine-Kontingent PUS-PER-GPU-FAMILY-per-project-region. Es wird ein Kontingentwert von 100 für Maschinen der GPU-Familie NVIDIA_H100 in der Region us-central1 angefordert.

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}

Anfragen zur Kontingenterhöhung ansehen

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

So zeigen Sie ausstehende Anfragen zur Kontingenterhöhung an:

Console

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

  2. Gehen Sie in der Google Cloud Console zu IAM und Verwaltung > Kontingente und Systemlimits:

    Zur Seite „Kontingente und Systemlimits“

  3. Neben den Kontingentwerten, für die eine Entscheidung zu zuvor eingereichten Erhöhungsanfragen aussteht, wird das Symbol Ausstehend angezeigt. Klicken Sie auf Ausstehend, um Details zu den ausstehenden Anfragen anzuzeigen.

Ausstehende Anfragen werden auch im Formular Kontingentänderungen angezeigt, wenn eine Kontingentanpassung angefordert wird.

So rufen Sie alle Anfragen zur Kontingenterhöhung auf, einschließlich ausstehender und vergangener Anfragen:

Console

  1. Gehen Sie in der Google Cloud Console zu IAM und Verwaltung > Kontingente und Systemlimits:

    Zur Seite „Kontingente und Systemlimits“

  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.

Kontingentüberschreibung erstellen

Wenn Sie die Nutzung einer bestimmten Ressource einschränken möchten, erstellen Sie eine Kontingentüberschreibung, indem Sie den Kontingentwert in einen Wert ändern, der kleiner als der Standardkontingentwert ist. Das Erstellen einer Kontingentüberschreibung wird manchmal auch als Nutzungsbegrenzung bezeichnet.

So erstellen Sie eine Kontingentüberschreibung: Kontingentwert aktualisieren

Kontingentüberschreibungen sind nicht für alle Dienste verfügbar. Dienstspezifische Informationen finden Sie in der Dokumentation zu Kontingenten und Systemlimits für Ihren Dienst.

Kontingentwert zurücksetzen

So setzen Sie den Kontingentwert zurück, nachdem eine Überschreibung angewendet wurde:

Console

  1. Gehen Sie in der Google Cloud Console zu IAM und Verwaltung > Kontingente und Systemlimits:

    Zur Seite „Kontingente und Systemlimits“

  2. Geben Sie Text in das Suchfeld Filter ein, um nach Ihrem Kontingent zu suchen. Legen Sie Hat Override: True fest, um nur Kontingente mit einer Überschreibung anzuzeigen.

  3. Auf der Seite „Kontingente“ wird neben den Kontingentlimits, die eine Überschreibung haben, Überschreibung angezeigt. Klicken Sie auf Überschreibung, um Details zu diesem Kontingent und eine Option zum Zurücksetzen des Werts aufzurufen.

  4. Wenn Sie bestätigen möchten, dass durch das Zurücksetzen Ihre Überschreibungen entfernt werden, klicken Sie auf das Kästchen vor Wert zurücksetzen und dann auf Wert zurücksetzen, um das Kontingent zurückzusetzen.

Führen Sie die gleichen Schritte wie unter Höheres Kontingentlimit anfordern aus, um ein Kontingent manuell zurückzusetzen. Achten Sie darauf, den neuen Wert gleich dem Standardwert festzulegen, der unter dem Kontingentnamen im Formular Kontingentänderungen angezeigt wird.

Kontingente mit der Cloud Quotas API verwalten

Über die Cloud Kontingente API können Sie aktuelle Kontingentinformationen abrufen und Kontingenteinstellungen für Google Cloud APIs und -Dienste festlegen. Hier finden Sie weitere Informationen:

Kontingente über die gcloud CLI verwalten

Stellen Sie zur Verwendung der gcloud CLI sicher, dass Sie die aktuelle Version der gcloud CLI einschließlich der Komponente für Beta-Befehle installiert und initialisiert haben. Wenn Sie Cloud Shell für die Interaktion mit Google Cloudverwenden, wird das gcloud CLI für Sie installiert.

Weitere Informationen finden Sie in den folgenden Abschnitten:

Projektkontingent anfordern

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

Nächste Schritte