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.

Wiederholungsverhalten

Das Wiederholungsverhalten umfasst Einstellungen, die festlegen, wie SDKs versucht wird, die Wiederherstellung nach Fehlern durchzuführen, die auf Anfragen zurückzuführen sind AWS-Services.

Wählen Sie zwischen den Modi standard und adaptive versuchen Sie es erneut

Wir empfehlen Ihnen, den standard Wiederholungsmodus zu verwenden, es sei denn, Sie sind sich sicher, dass Ihre Verwendung dafür besser geeignet ist. adaptive

Wenn Sie den adaptive Modus verwenden möchten, muss Ihre Anwendung Clients erstellen, die für jede Ressource konzipiert sind, die möglicherweise gedrosselt wird. In diesem Fall ist eine Ressource besser abgestimmt, als nur an jede einzelne Ressource zu denken AWS-Service. AWS-Services kann zusätzliche Dimensionen haben, die sie verwenden, um Anfragen zu drosseln. Lassen Sie uns den Amazon DynamoDB-Service als Beispiel verwenden. DynamoDB verwendet AWS-Region plus die Tabelle, auf die zugegriffen wird, um Anfragen zu drosseln. Das bedeutet, dass eine Tabelle, auf die Ihr Code zugreift, möglicherweise stärker gedrosselt wird als andere. Wenn Ihr Code denselben Client für den Zugriff auf alle Tabellen verwendet hat und Anfragen an eine dieser Tabellen gedrosselt werden, reduziert der adaptive Wiederholungsmodus die Anforderungsrate für alle Tabellen. Ihr Code sollte so konzipiert sein, dass er einen Client pro egion-and-table R-Paar hat. Wenn Sie bei der Verwendung des adaptive Modus eine unerwartete Latenz feststellen, finden Sie weitere Informationen in den spezifischen AWS Dokumentationsleitfaden für den Dienst, den Sie verwenden.

Einzelheiten zur Implementierung im Wiederholungsmodus

Das Tool AWS SDKsverwenden Sie Token-Buckets, um zu entscheiden, ob eine Anfrage erneut versucht werden soll und (im Fall des adaptive Wiederholungsmodus) wie schnell Anfragen gesendet werden sollen. Zwei Token-Buckets werden verwendetSDK: ein Token-Bucket für Wiederholungsversuche und ein Token-Bucket für die Anforderungsrate.

Im Folgenden finden Sie den allgemeinen Pseudocode für den Modus und den Wiederholungsmodus: standard adaptive

MakeSDKRequest() {
  attempts = 0
  loop {
    GetSendToken()
    response = SendHTTPRequest()
    RequestBookkeeping(response)
    if not Retryable(response)
      return response
    attempts += 1
    if attempts >= MAX_ATTEMPTS:
      return response
    if not HasRetryQuota(response)
      return response
    delay = ExponentialBackoff(attempts)
    sleep(delay)
  }
}

Im Folgenden finden Sie weitere Informationen zu den im Pseudocode verwendeten Komponenten:

GetSendToken:

Dieser Schritt wird nur im adaptive Wiederholungsmodus verwendet. In diesem Schritt wird ein Token aus dem Token-Bucket für die Anforderungsrate abgerufen. Wenn ein Token nicht verfügbar ist, wartet es, bis eines verfügbar wird. SDKMöglicherweise stehen Ihnen Konfigurationsoptionen zur Verfügung, mit denen die Anfrage fehlschlagen kann, anstatt zu warten. Tokens im Bucket werden mit einer Geschwindigkeit aufgefüllt, die dynamisch auf der Grundlage der Anzahl der vom Client empfangenen Drosselungsantworten bestimmt wird.

SendHTTPRequest:

Dieser Schritt sendet die Anfrage an AWS. Die meisten AWS SDKsverwenden eine HTTP Bibliothek, die Verbindungspools verwendet, um eine bestehende Verbindung wiederzuverwenden, wenn HTTP Sie eine Anfrage stellen. Im Allgemeinen werden Verbindungen wiederverwendet, wenn eine Anfrage aufgrund von Drosselungsfehlern fehlgeschlagen ist, aber nicht, wenn eine Anfrage aufgrund eines vorübergehenden Fehlers fehlschlägt.

RequestBookkeeping:

Token werden dem Token-Bucket hinzugefügt, wenn die Anfrage erfolgreich ist. Nur im adaptive Wiederholungsmodus wird die Füllrate des Token-Buckets für die Anforderungsrate auf der Grundlage der Art der erhaltenen Antwort aktualisiert.

Retryable:

In diesem Schritt wird anhand der folgenden Kriterien bestimmt, ob eine Antwort erneut versucht werden kann:

Vorübergehende Fehler (HTTPStatuscodes 400, 408, 500, 502, 503 und 504) und Drosselungsfehler (HTTPStatuscodes 400, 403, 429, 502, 503 und 509) können alle potenziell wiederholt werden. SDKDas Wiederholungsverhalten wird in Kombination mit Fehlercodes oder anderen Daten aus dem Dienst bestimmt.

MAX_ATTEMPTS:

Die Standardanzahl der maximalen Versuche wird durch die retry_mode Einstellung festgelegt, sofern sie nicht durch die Einstellung überschrieben wird. max_attempts

HasRetryQuota

In diesem Schritt wird ein Token aus dem Token-Bucket für Wiederholungsversuche abgerufen. Wenn der Token-Bucket für Wiederholungen leer ist, wird die Anfrage nicht erneut versucht.

ExponentialBackoff

Bei einem Fehler, der erneut versucht werden kann, wird die Verzögerung beim erneuten Versuch anhand eines verkürzten exponentiellen Backoffs berechnet. Die SDKs Verwendung eines verkürzten binären exponentiellen Backoffs mit Jitter. Der folgende Algorithmus zeigt, wie die Zeit bis zum Schlafen (in Sekunden) für eine Antwort auf eine Anfrage definiert wird: i

seconds_to_sleep_i = min(b*r^i, MAX_BACKOFF)

Im vorherigen Algorithmus gelten die folgenden Werte:

b = random number within the range of: 0 <= b <= 1

r = 2

MAX_BACKOFF = 20 secondsfür die meistenSDKs. Weitere Informationen finden Sie in Ihrer spezifischen SDK Anleitung oder Ihrem Quellcode.

Kompatibilität mit AWS SDKs

Im Folgenden werden die in diesem Thema beschriebenen Funktionen und Einstellungen SDKs unterstützt. Alle teilweisen Ausnahmen werden vermerkt. Alle Einstellungen für JVM Systemeigenschaften werden unterstützt von AWS SDK for Java und die AWS SDK for Kotlin nur.