Kontingente und Limits

Auf dieser Seite werden die Kontingente in API Gateway beschrieben.

Limits für APIs, API-Konfigurationen und Gateways

In API Gateway gelten folgende Limits für APIs, API-Konfigurationen und Gateways:

  • APIs – 50 insgesamt
  • API-Konfigurationen – 100 pro API
  • Gateways – 50 pro Region

Wenn Sie versuchen, eine zweite API-Konfiguration zu erstellen, bevor die Erstellung der ersten API-Konfiguration für dieselbe API abgeschlossen ist, sind eine oder beide Konfigurationen möglicherweise nicht für die spätere Verwendung in einem Gateway verfügbar.

Ratenlimits anfordern

Standardmäßig gilt ein Ratenlimit von 10.000.000 Kontingenteinheiten pro 100 Sekunden für jedes Diensterstellerprojekt. Für jeden Aufruf von services.check und für jeden von services.report aufgezeichneten Vorgang wird jeweils eine Kontingenteinheit verbraucht.

Nutzlastgrößenlimits

Die folgenden Limits gelten speziell für die maximale Nutzlastgröße bei Traffic durch bereitgestellte Gateways:

Grenzwert Menge
Größe der Anfrage 32 MB
Größe der Antwort 32 MB
Größe der gRPC-Transcodierungsantwort 1 Megabyte
Größe der gRPC-Transcodierungsanfrage 1 Megabyte

Streaming wird nicht unterstützt.

Größenbeschränkungen für Header

Die folgenden Limits gelten speziell für die maximale Headergröße bei Traffic durch bereitgestellte Gateways:

Limit Betrag
Größe der Anfrageheader 60 Kilobyte

Der vom API Gateway aufgerufene Back-End-Dienst hat möglicherweise niedrigere Limits.

Kontingent erhöhen

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"
}