Pub/Sub-Kontingente und -Limits

Google Cloud legt mithilfe von Kontingenten fest, welchen Anteil einer freigegebenen Google Cloud-Ressource Sie nutzen können. Jedes Kontingent stellt eine bestimmte zählbare Ressource dar, z. B. API-Aufrufe an einen bestimmten Dienst, die Anzahl der an einen bestimmten Dienst gesendeten Bytes oder die Anzahl der Streamingverbindungen, die von Ihrem Projekt gleichzeitig verwendet werden.

Viele Dienste haben auch Limits, die nicht mit dem Kontingentsystem in Zusammenhang stehen. Dies sind feste Einschränkungen wie die maximale Nachrichtengröße oder die Anzahl der Pub/Sub-Ressourcen, die Sie in einem Projekt erstellen können, die nicht erhöht oder verringert werden können.

Kontingente aufrufen und verwalten

Sie können die aktuellen Kontingentlimits eines Projekts und deren Nutzung im Dashboard "IAM & Verwaltung" für Kontingente ansehen. Sie können dieses Dashboard auch für folgende Aufgaben verwenden:

• Kontingentlimits reduzieren
• Höhere Kontingentlimits beantragen

Weitere Informationen zum Monitoring und zu Benachrichtigungen zu Ihrer Kontingentnutzung finden Sie unter Monitoring.

Zuordnung der Kontingentnutzung

Für den Push-Abonnentendurchsatz wird die Kontingentnutzung anhand des Projekts berechnet, in dem das Push-Abo enthalten ist. Das ist das Projekt, das im Namen des Abos angezeigt wird.

Bei allen anderen Kontingenten wird die Nutzung dem Projekt in Rechnung gestellt, das mit den in der Anfrage angegebenen Anmeldedaten verknüpft ist. Die Kontingentnutzung wird nicht dem Projekt in Rechnung gestellt, das die angeforderte Ressource enthält.

Beispiel: Wenn ein Dienstkonto in Projekt A eine Veröffentlichungsanfrage an ein Thema in Projekt B sendet, wird das Kontingent für Projekt A belastet. In einigen Fällen möchten Sie möglicherweise, dass die Kontingentnutzung einem anderen Projekt in Rechnung gestellt wird. Mit dem Systemparameter X-Goog-User-Project können Sie das Projekt für die Kontingentzuordnung ändern. Weitere Informationen zu X-Goog-User-Project finden Sie unter Systemparameter.

Sie können mit der gcloud CLI das Projekt für die Kontingentzuordnung für eine bestimmte Anfrage festlegen. Die gcloud CLI sendet den X-Goog-User-Project-Anfrageheader.

Sie benötigen die Rolle roles/serviceusage.serviceUsageConsumer oder eine benutzerdefinierte Rolle mit der Berechtigung serviceusage.services.use für das Projekt, das Sie für die Kontingentzuordnung verwenden möchten.

Im folgenden Beispiel wird gezeigt, wie Sie eine Liste der Abos im Projekt RESOURCE_PROJECT abrufen und dabei das Kontingent für Administratoraktionen dem Projekt QUOTA_PROJECT in Rechnung stellen. Führen Sie den folgenden Befehl in Ihrem Google Cloud CLI-Terminal aus:

gcloud pubsub subscriptions list --project=
RESOURCE_PROJECT --billing-project=
QUOTA_PROJECT

Ersetzen Sie QUOTA_PROJECT durch die ID des Google Cloud-Projekts, auf das das Kontingent angewendet werden soll.

In Pub/Sub wird die Rechnung immer für das Projekt ausgestellt, das die Ressource enthält. Sie können das Projekt nur für die Kontingentzuordnung ändern.

Pub/Sub Kontingente

Die in der folgenden Tabelle aufgelisteten Kontingente können pro Projekt im Dashboard „APIs & Dienste“ für Kontingente aufgerufen und bearbeitet werden.

Regionale Kontingente sind in drei Typen unterteilt:

• Große Regionen: europe-west1, europe-west4, us-central1, us-east1, us-east4, us-west1, us-west2
• Mittelgroße Regionen: asia-east1, asia-northeast1, asia-southeast1, europe-west2, europe-west3
• Kleine Regionen: alle anderen Regionen

Die Kontingente für die genau einmalige Zustellung sind regionsspezifisch. Weitere Informationen zu den einzelnen Regionen finden Sie in der folgenden Tabelle.

Durchsatzkontingenteinheiten

Die Nutzung von Durchsatzkontingenten wird in Einheiten von 1 KB gemessen. 1 KB entspricht 1.000 Byte. Beispiel: In einer PublishRequest mit 105 Nachrichten mit jeweils 50 Byte beträgt die Nutzerdatengröße 105 * 50 bytes = 5250 bytes. Die Kontingentnutzung beläuft sich also auf max(1kB, ceil(5250 bytes/1000)) = 6kB.

Ressourcenlimits

Dienstkonto für höhere Kontingente verwenden

Wenn Sie die Google Cloud CLI mit einem normalen Nutzerkonto – keinem Dienstkonto – verwenden, sind Pub/Sub-Vorgänge auf eine für manuelle Vorgänge geeignete Rate beschränkt. Raten, die dieses Limit überschreiten, führen zum Fehler RESOURCE_EXHAUSTED. Dies können Sie durch die Verwendung von Anmeldedaten für ein Dienstkonto verhindern. Wenn Sie zur Automatisierung die Anmeldedaten der gcloud CLI verwenden möchten, aktivieren Sie ein Dienstkonto für Ihre Pub/Sub-Vorgänge.

Standortendpunkte zum Weiterleiten von Anfragen verwenden

Wenn Sie in bestimmten Regionen zusätzliche Kontingente haben, können Sie Anfragen mithilfe standortbezogener Pub/Sub-Endpunkte an diese Regionen weiterleiten. Wenn Sie Nachrichten in einem globalen Endpunkt veröffentlichen, leitet der Pub/Sub-Dienst den Traffic möglicherweise an eine Region weiter, die nicht über ausreichende Kontingente verfügt.

Kontingentabweichungen

Kontingentabweichungen können auftreten, wenn veröffentlichte oder empfangene Nachrichten kleiner als 1.000 Byte sind. Beispiel:

• Wenn Sie zehn Nachrichten mit je 500 Byte in separaten Anfragen veröffentlichen, beträgt Ihre Kontingentnutzung als Publisher 10.000 Byte. Das liegt daran, dass Nachrichten unter 1.000 Byte automatisch auf 1.000 Byte aufgerundet werden.

• Wenn Sie die zehn Nachrichten innerhalb einer einzelnen Pull-Antwort empfangen, beträgt Ihre Kontingentnutzung als Abonnent möglicherweise nur 5 KB. Dies liegt daran, dass für die Bestimmung des Gesamtkontingents die Nachrichten in ihrer tatsächlichen Größe zusammengefasst werden.

• Auch das Gegenteil kann der Fall sein. Die Kontingentnutzung als Abonnent kann über der Kontingentnutzung als Publisher liegen, wenn Sie mehrere Nachrichten in einer einzelnen Veröffentlichungsanfrage veröffentlichen oder die Nachrichten in separaten Pull-Anfragen empfangen.