Drosseln der API-Anforderungen für einen besseren Durchsatz - Amazon API Gateway

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Drosseln der API-Anforderungen für einen besseren Durchsatz

Sie können Drosselungen und Kontingente für Ihre APIs konfigurieren, um sie davor zu schützen, von zu vielen Anfragen überfordert zu werden. Sowohl Drosselungen als auch Quoten werden mit bestem Bemühen angewendet und sollten als Ziele und nicht als garantierte Anforderungsobergrenzen betrachtet werden.

API Gateway drosselt Anfragen an Ihre API mit dem Token-Bucket-Algorithmus, wobei ein Token für eine Anforderung gilt. Insbesondere überprüft API Gateway die Rate und einen Burst von Anfragen für alle APIs in Ihrem Konto pro Region. Im Token-Bucket-Algorithmus kann ein Burst ein vordefiniertes Überlaufen dieser Grenzwerte ermöglichen, aber andere Faktoren können auch dazu führen, dass Grenzwerte in einigen Fällen überlaufen werden.

Wenn Anfrageeinreichungen die Steady-State-Anfragerate und Steigerungs-Limits überschreiten, drosselt API Gateway Anfragen. Kunden erhalten möglicherweise 429 Too Many Requests Fehlerantworten an dieser Stelle. Bei der Erfassung solcher Ausnahmen kann der Client die fehlgeschlagenen Anforderungen in einer Weise erneut einreichen, die raten-begrenzend ist.

Als API-Entwickler können Sie die Target-Limits für individuelle API-Stufen oder -Methoden festlegen, um die Gesamtleistung in allen APIs in Ihrem Konto zu verbessern. Alternativ können Sie Nutzungspläne aktivieren, um Drosselungen für Client-Anforderungseinreichungen basierend auf angegebenen Anforderungsraten und -kontingente einzurichten.

So werden Einstellungen für die Drosselungsgrenzen in API Gateway angewendet:

Bevor Sie Drosselungs- und Kontingenteinstellungen für Ihre API konfigurieren, sollten Sie wissen, wie sie von Amazon API Gateway angewendet werden.

Amazon API Gateway bietet vier grundlegende Arten von Drosselungseinstellungen:

  • AWS-Drosselungslimitswerden auf alle Konten und Kunden in einer Region angewendet. Diese Limit-Einstellungen verhindern, dass Ihre API – und Ihr Konto – von zu vielen Anfragen überfordert wird. Diese Grenzwerte werden durch AWS festgelegt und können von einem Kunden nicht geändert werden.

  • Grenzwerte pro Konto werden auf alle APIs in einem Konto in einer bestimmten Region angewendet. Das Ratenlimit auf Kontoebene kann auf Anforderung erhöht werden – höhere Limits sind mit APIs möglich, die kürzere Timeouts und kleinere Nutzlasten aufweisen. Um eine Steigerung der Ablehnungslimits auf Kontoebene pro Region anzufordern, wenden Sie sich an das AWS Supportcenter. Weitere Informationen finden Sie unter Amazon API Gateway-Kontingente und wichtige Hinweise. Beachten Sie, dass diese Grenzwerte nicht höher sein können als die AWS-Drossel-Limits.

  • Die Drosselungsgrenzen pro API pro Stufe werden auf API-Methodenebene für eine Stufe angewendet. Sie können für alle Methoden dieselben Einstellungen konfigurieren oder für jede Methode unterschiedliche Drosseleinstellungen konfigurieren. Beachten Sie, dass diese Grenzwerte nicht höher sein können als die AWS-Drosselungslimits.

  • Client-basierte Drossel-Limits werden auf Clients angewendet, die mit Ihrem Nutzungsplan verknüpfte API-Schlüssel als Client-ID verwenden. Beachten Sie, dass diese Limits nicht höher sein dürfen als die Grenzwerte pro Konto.

Drosselungsbezogene API Gateway-Einstellungen werden in der folgenden Reihenfolge angewendet:

Drosselung auf Kontoebene pro Region

Standardmäßig begrenzt API Gateway die Steady-State-Anfragen pro Sekunde (RPS) für alle APIs innerhalb eines AWS-Kontos pro Region. Die Steigerung (also die maximale Bucket-Größe) wird über alle APIs innerhalb eines AWS-Kontos pro Region wird ebenfalls beschränkt. In API Gateway entspricht das Burst-Limit der maximalen Target-Anzahl gleichzeitiger Anfragen, die API Gateway vor Rückgabe von 429 Too Many Requests-Fehlerantworten ausführt. Weitere Informationen zu Drosselungskontingenten finden Sie unter Amazon API Gateway-Kontingente und wichtige Hinweise.

Konfiguration von Drosselungs-Targets auf API-Ebene und Stufenebene in einem Nutzungsplan

In einem Nutzungsplan können Sie ein Drosselungs-Target pro Methode für alle Methoden auf API- oder Stufenebene festlegen. Sie können eine Drosselungsrate angeben, d. h. die Rate in Anfragen pro Sekunde, mit der Token zum Token-Bucket hinzugefügt werden. Sie können auch einen Drosselungs-Burst angeben, der der Kapazität des Token-Buckets entspricht.

Konfigurieren von Drosselungs-Targets auf Stufenebene

Sie können die AWS-CLI, die SDKs und die AWS Management Console verwenden, um Drosselungs-Targets auf Stufenebene zu erstellen. Weitere Informationen finden Sie unter Aktualisieren von Stufeneinstellungen.

Konfiguration von Drosselungs-Targets auf Methodenebene in einem Nutzungsplan

Sie können weitere Drosselungs-Targets auf Methodenebene in Usage Plans (Nutzungsplänen) festlegen, wie unter Erstellen eines Nutzungsplans dargestellt. In der API Gateway-Konsole werden diese durch die Angabe von Resource=<resource>, Method=<method> in der Einstellung Configure Method Throttling (Methodendrosselung konfigurieren) festgelegt. Im PetStore-Beispiel können Sie beispielsweise Resource=/pets, Method=GET festlegen.