Anfragen an Ihre HTTP-API drosseln - 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.

Anfragen an Ihre HTTP-API drosseln

Sie können Drosselungen für Ihre APIs konfigurieren, um sie davor zu schützen, von zu vielen Anfragen überfordert zu werden. Drosselungen 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 -Routen festlegen, um die Gesamtleistung in allen APIs in Ihrem Konto zu verbessern.

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.

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 als die AWS Drosselungsgrenzen sein können.

Drosselung auf Routenebene

Sie können die Drosselung auf Routenebene festlegen, um die Anforderungs-Drosselungslimits auf Kontoebene für eine bestimmte Stufe oder für individuelle Routen in Ihrer API zu überschreiben. Die Standardgrenzen für die Routendrosselung können die Ratenlimits auf Kontoebene nicht überschreiten.

Sie können die Drosselung auf Routenebene konfigurieren, indem Sie die verwende AWS CLI. Mit dem folgenden Befehl wird die benutzerdefinierte Einschränkung für die angegebene Stufe und Route einer API konfiguriert.

aws apigatewayv2 update-stage \ --api-id a1b2c3d4 \ --stage-name dev \ --route-settings '{"GET /pets":{"ThrottlingBurstLimit":100,"ThrottlingRateLimit":2000}}'