Über Kontingente

API Gateway bietet Kontingente, mit denen sich steuern lässt, wie oft Anwendungen Ihre API aufrufen können. Durch Festlegen eines Kontingents können Sie Nutzungslimits angeben, um Ihre API vor einer übermäßigen Anzahl von Anfragen zu schützen, die von aufrufenden Anwendungen eingehen. Eine übermäßige Anzahl von Anfragen kann durch einen einfachen Tippfehler oder ein ineffizient gestaltetes System verursacht werden, das unnötige Aufrufe Ihrer API ausführt.

Unabhängig von der Ursache ist es für den Gesamtzustand der API wichtig, den Traffic von einer Quelle zu blockieren, sobald er einen bestimmten Wert erreicht. Durch Festlegen eines Kontingents sorgen Sie dafür, dass sich eine einzige Anwendung nicht negativ auf andere Anwendungen auswirkt, die Ihre API verwenden.

**Hinweis**: Für API Gateway steuern Sie Kontingente wie im Cloud Endpoints-Dokument unter Über Kontingente beschrieben.

Kontingente gelten für die gesamte API

Sie definieren Kontingentmesswerte und -limits in einer API-Konfiguration. API Gateway wendet sie jedoch auf die API an, zu der die API-Konfiguration gehört, und nicht nur auf diese API-Konfiguration. Jedes Mal, wenn Sie eine API-Konfiguration erstellen, ersetzen die darin deklarierten Messwerte und Limits die, die in den vorherigen API-Konfigurationen der API deklariert wurden. Es werden nur die Messwerte und Limits aus der zuletzt erstellten API-Konfiguration erzwungen.

Wenn für eine API mehr als eine API-Konfiguration bereitgestellt wird, hat dies zwei Folgen:

• Wenn Sie den Wert eines Limits ändern, ändert sich das Limit für alle Gateways der API, einschließlich der Gateways, die eine frühere API-Konfiguration verwenden.

• Wenn Sie einen Messwert umbenennen oder entfernen, bleibt auf allen Gateways, die noch eine frühere API-Konfiguration verwenden, eine ungültige Kontingentkonfiguration zurück. Anfragen an die Methoden dieser Gateways, für die Kontingente erzwungen werden, schlagen mit einem HTTP-Fehler 500 und der Meldung Failed to call Service Control Quota. fehl.

Achtung: Überprüfen Sie Ihre Kontingentmesswerte und ‑limits, um sicherzustellen, dass sie in allen aktiven Konfigurationen einheitlich sind. Wenn Sie die Messwertnamen nicht einheitlich halten können, aktualisieren Sie jedes Gateway der API auf die zuletzt erstellte API-Konfiguration.

Informationen zum Suchen und Korrigieren einer ungültigen Kontingentkonfiguration finden Sie unter API-Anfrage gibt einen HTTP-500-Fehler für eine Methode zurück, für die Kontingente erzwungen werden.