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.
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:
Bevor Sie die Einstellungen für Drosselung und Kontingente für Ihre API konfigurieren, sollten Sie die Drosselungs- und Kontingenteinstellungen für Ihre API verstehen und wissen, wie API Gateway sie anwendet.
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.
API Gateway wendet Ihre Drosselungseinstellungen in der folgenden Reihenfolge an:
-
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, SDKs und die AWS Management Console verwenden, um einen Nutzungsplan zu erstellen. Informationen zum Erstellen eines Nutzungsplans finden Sie unter Nutzungspläne und API-Schlüssel für REST APIs in API Gateway.
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 zur Verwendung von AWS Management Console zur Erstellung von Drosselungs-Targets auf Stufenebene finden Sie unter Ändern der Stufeneinstellungen. Weitere Informationen zur Verwendung der AWS-CLI zum Erstellen von Drosselungs-Targets 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. Im PetStore-Beispiel können Sie beispielsweise <method>Resource=/pets, Method=GET festlegen.
