OS Config-Kontingente

In diesem Dokument werden die Anfragekontingente für die maximale Anzahl von Anfragen beschrieben, die Sie an der OS Config API für die VM Manager-Tools in einem Projekt vornehmen können. Außerdem werden die Zuweisungskontingente für OS Config-Ressourcen behandelt.

Ein Kontingent schränkt ein, wie viel von einer bestimmten gemeinsam genutzten Google Cloud-Ressource Ihr Google Cloud-Projekt nutzen kann, einschließlich Hardware, Software und Netzwerkkomponenten. Daher sind Kontingente Teil eines Systems, das Folgendes tut:

  • Ihre Nutzung oder Ihren Verbrauch von Google Cloud-Produkten und -Diensten überwachen.
  • Ihren Verbrauch dieser Ressourcen einschränken, um u. a. für Fairness zu sorgen und Nutzungsspitzen zu reduzieren.
  • Konfigurationen verwalten, die automatisch vorgeschriebene Einschränkungen erzwingen.
  • Möglichkeit, das Kontingent anzufordern oder zu ändern.

Wenn ein Kontingentlimit überschritten wird, blockiert das System in den meisten Fällen den Zugriff auf die entsprechende Google-Ressource und die Aufgabe, die Sie ausführen möchten, schlägt fehl. In den meisten Fällen gelten Kontingente für jedes Google Cloud-Projekt und werden von allen Anwendungen und IP-Adressen geteilt, die dieses Google Cloud-Projekt verwenden.

Anfragekontingente

Wenn Sie die Google Cloud CLI oder die Google Cloud Console verwenden, stellen Sie auch Anfragen an die API und diese Anfragen werden auf Ihr Anfragekontingent angerechnet. Dasselbe gilt für Zugriffe auf die API über Dienstkonten.

Kontingente werden in einem Intervall von 60 Sekunden durchgesetzt. Wenn Sie an einem beliebigen Punkt innerhalb von 60 Sekunden ein bestimmtes Limit erreichen, können Sie keine weiteren Anfragen senden, sondern müssen erst warten, bis Ihr Kontingent-Bucket aktualisiert wurde.

Kontingente pro Nutzer

Kontingentgruppe Details Standardkontingent
Leseanfragen
  • Beschreibung: Kontingent für die Methoden *.get, *.describe und *.list.
  • Messwert: osconfig.googleapis.com/read_requests

    Rufen Sie dieses Kontingent in der Google Cloud Console auf:

    Kontingente aufrufen

 60 Anfragen pro Nutzer und Minute
Schreibanfragen
  • Beschreibung: Kontingent für die Methoden *.create, *.update, *.exec, *.cancel und *.delete.
  • Messwert: osconfig.googleapis.com/write_requests

    Rufen Sie dieses Kontingent in der Google Cloud Console auf:

    Kontingente aufrufen

 60 Anfragen pro Nutzer und Minute
Suchanfragen (Legacy-Beta)
  • Beschreibung: Kontingent für die Methode *.lookupEffectiveGuestPolicy.
  • Messwert: osconfig.googleapis.com/lookup_requests

    Rufen Sie dieses Kontingent in der Google Cloud Console auf:

    Kontingente aufrufen

 600 Anfragen pro Nutzer und Minute

Kontingente pro Region

Kontingentgruppe Details Standardkontingent
Leseanfragen
  • Beschreibung: Kontingent für die Methoden *.get, *.describe und *.list.
  • Messwert: osconfig.googleapis.com/regional_zonal_read_requests

    Rufen Sie dieses Kontingent in der Google Cloud Console auf:

    Kontingente aufrufen

 100 Anfragen pro Region und Minute
Schreibanfragen
  • Beschreibung: Kontingent für die Methoden *.create, *.update, *.patch, *.cancel und *.delete.
  • Messwert: osconfig.googleapis.com/regional_zonal_write_requests

    Rufen Sie dieses Kontingent in der Google Cloud Console auf:

    Kontingente aufrufen

 60 Anfragen pro Region und Minute

Zuteilungskontingente

Zuordnungskontingente sind die maximale Anzahl an Ressourcen, die Sie von diesem Ressourcentyp erstellen können. OS Config-Ressourcen umfassen Folgendes: Patchbereitstellungen, Zuweisungen von Betriebssystemrichtlinien und Gastrichtlinien.

Die folgenden Kontingente werden im Laufe der Zeit nicht zurückgesetzt und stattdessen freigegeben, wenn Sie die Ressource freigeben.

Ressource Details Standardkontingent
Patchjobs
  • Beschreibung: Kontingent für die Anzahl der Patchjobs, die in einem Projekt erstellt werden können.
  • Messwert: osconfig.googleapis.com/patch_deployment_count

    Rufen Sie dieses Kontingent in der Google Cloud Console auf:

    Kontingente aufrufen

 100 Patchjobs pro Projekt
Zuweisungen von Betriebssystemrichtlinien
  • Beschreibung: Kontingent für die Anzahl der Zuweisungen von Betriebssystemrichtlinien, die für jede Zone in einem Projekt erstellt werden können.
  • Messwert: osconfig.googleapis.com/os_policy_assignment_count

    Rufen Sie dieses Kontingent in der Google Cloud Console auf:

    Kontingente aufrufen

 20 Betriebssystemrichtlinien pro Zone und Projekt
Gastrichtlinien (Legacy-Beta)
  • Beschreibung: Kontingent für die Anzahl der Gastrichtlinien, die in einem Projekt erstellt werden können.
  • Messwert: osconfig.googleapis.com/guest_policy_count

    Rufen Sie dieses Kontingent in der Google Cloud Console auf:

    Kontingente aufrufen

 100 Gastrichtlinien pro Projekt

Anfrage- und Zuweisungskontingente verwalten

So verwalten Sie die Anfrage- und Zuweisungskontingente für Ihr Projekt:

  • Folgen Sie den Best Practices für das Beibehalten von API-Ratenlimits.

  • Verwenden Sie die Google Cloud Console, um Kontingente aufzurufen und zu bearbeiten:

    Kontingente aufrufen

    • Informationen zum Verringern von Anfragekontingenten finden Sie unter Nutzung einschränken.
    • Wenn Sie höhere Anfragekontingente benötigen, können Sie ein höheres Kontingentlimit anfordern. Fügen Sie Ihrer Anfrage Informationen zur Nutzungsrate in Ihrer Umgebung hinzu. Hierzu gehören VM Manager-Audit-Logs oder andere Fehlermeldungen, die besagen, dass die Ratenbegrenzung überschritten wurde. Dabei ist es auch hilfreich, wenn Sie hier Informationen wie zukünftige Wachstumspläne, Regionen- oder Zonenverteilung sowie zusätzliche Anforderungen oder Abhängigkeiten angeben.

Nächste Schritte