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.
Themen
- So werden Einstellungen für die Drosselungsgrenzen in API Gateway angewendet:
- Drosselung auf Kontoebene pro Region
- Konfiguration von Drosselungs-Targets auf API-Ebene und Stufenebene in einem Nutzungsplan
- Konfigurieren von Drosselungs-Targets auf Stufenebene
- Konfiguration von Drosselungs-Targets auf Methodenebene in einem Nutzungsplan
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 Drosselungslimits gelten für alle Konten und Kunden in einer Region. Diese Limit-Einstellungen verhindern, dass Ihre API – und Ihr Konto – von zu vielen Anfragen überfordert wird. Diese Limits werden von einem Kunden festgelegt AWS und können von diesem 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 als die AWS Drosselungsgrenzen sein können. -
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 als die AWS Drosselungsgrenzen sein dürfen.
-
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:
-
Client-basierte Drossel-Limits oder Drossel-Limits pro Methode, die Sie im Nutzungsplan für eine API-Stufe festlegen
-
Drossel-Limits pro Methode, die Sie für eine API-Stufe festlegen
-
AWS Regionale Drosselung
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.
Sie können die AWS CLI, die SDKs und die verwenden, AWS Management Console um einen Nutzungsplan zu erstellen. Weitere Informationen zum Erstellen eines Nutzungsplans finden Sie unterErstellen und Verwenden von Nutzungsplänen mit API-Schlüsseln.
Konfigurieren von Drosselungs-Targets auf Stufenebene
Sie können die AWS CLI, die SDKs und die verwenden, AWS Management Console um Drosselungsziele auf Stufenebene zu erstellen.
Weitere Informationen zur Verwendung von zum Erstellen von Drosselungszielen auf AWS Management Console Stufenebene finden Sie unter. Aktualisieren von Stufeneinstellungen Weitere Informationen zur Verwendung der AWS CLI zum Erstellen von Drosselungszielen auf Stufenebene finden Sie unter create-stage.
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= in der Einstellung Configure Method Throttling (Methodendrosselung konfigurieren) festgelegt. Für dieses Beispiel könnten Sie beispielsweise, angebenPetStore. <method>Resource=/pets Method=GET
