RetryOptions Klasse
- java.
lang. Object - com.
microsoft. azure. cosmosdb. RetryOptions
- com.
public class RetryOptions
Kapselt Wiederholungsoptionen im Azure Cosmos DB-Datenbankdienst.
Zusammenfassung zum Konstruktor
Konstruktor | Beschreibung |
---|---|
RetryOptions() |
Erstellt eine neue instance der RetryOptions-Klasse und initialisiert alle Eigenschaften als Standardwerte. |
Methodenzusammenfassung
Modifizierer und Typ | Methode und Beschreibung |
---|---|
int |
getMaxRetryAttemptsOnThrottledRequests()
Ruft die maximale Anzahl von Wiederholungen ab, wenn die Anforderung fehlschlägt, weil der Dienst die Ratenbegrenzung auf den Client angewendet hat. |
int |
getMaxRetryWaitTimeInSeconds()
Ruft die maximale Wiederholungszeit in Sekunden ab. |
void |
setMaxRetryAttemptsOnThrottledRequests(int maxRetryAttemptsOnThrottledRequests)
Legt die maximale Anzahl von Wiederholungen für den Fall fest, dass die Anforderung fehlschlägt, weil der Dienst die Ratenbegrenzung auf den Client angewendet hat. Wenn ein Client Anforderungen schneller als die zulässige Rate sendet, gibt der Dienst HttpStatusCode 429 (Too Many Request) zurück, um den Client zu drosseln. Die aktuelle Implementierung im SDK wartet dann auf die Zeit, die der Dienst ihr mitteilt, dass sie warten soll, und wiederholen sie, nachdem die Zeit verstrichen ist. Der Standardwert ist 9. Dies bedeutet, dass für den Fall, dass die Anforderung gedrosselt wird, dieselbe Anforderung maximal 10 Mal an den Server ausgegeben wird, bevor ein Fehler an die Anwendung zurückgegeben wird. |
void |
setMaxRetryWaitTimeInSeconds(int maxRetryWaitTimeInSeconds)
Legt die maximale Wiederholungszeit in Sekunden fest. Wenn eine Anforderung aufgrund eines Drosselungsfehlers fehlschlägt, sendet der Dienst eine Antwort zurück, die einen Wert enthält, der angibt, dass der Client vor Ablauf des Zeitraums keine Wiederholungen ausführen sollte (Wiederholungs-Nach). Mit dem Flag MaxRetryWaitTime kann die Anwendung eine maximale Wartezeit für alle Wiederholungsversuche festlegen. Wenn die kumulative Wartezeit die MaxRetryWaitTime überschreitet, beendet das SDK die Wiederholung und gibt den Fehler an die Anwendung zurück. Der Standardwert ist 30 Sekunden. |
String | toString() |
Details zum Konstruktor
RetryOptions
public RetryOptions()
Erstellt eine neue instance der RetryOptions-Klasse und initialisiert alle Eigenschaften als Standardwerte.
Details zur Methode
getMaxRetryAttemptsOnThrottledRequests
public int getMaxRetryAttemptsOnThrottledRequests()
Ruft die maximale Anzahl von Wiederholungen ab, wenn die Anforderung fehlschlägt, weil der Dienst die Ratenbegrenzung auf den Client angewendet hat.
Gibt zurück:
getMaxRetryWaitTimeInSeconds
public int getMaxRetryWaitTimeInSeconds()
Ruft die maximale Wiederholungszeit in Sekunden ab.
Gibt zurück:
setMaxRetryAttemptsOnThrottledRequests
public void setMaxRetryAttemptsOnThrottledRequests(int maxRetryAttemptsOnThrottledRequests)
Legt die maximale Anzahl von Wiederholungen für den Fall fest, dass die Anforderung fehlschlägt, weil der Dienst die Ratenbegrenzung auf den Client angewendet hat.
Wenn ein Client Anforderungen schneller als die zulässige Rate sendet, gibt der Dienst HttpStatusCode 429 (Too Many Request) zurück, um den Client zu drosseln. Die aktuelle Implementierung im SDK wartet dann auf die Zeit, die der Dienst ihr mitteilt, dass sie warten soll, und wiederholen sie, nachdem die Zeit verstrichen ist.
Der Standardwert ist 9. Dies bedeutet, dass für den Fall, dass die Anforderung gedrosselt wird, dieselbe Anforderung maximal 10 Mal an den Server ausgegeben wird, bevor ein Fehler an die Anwendung zurückgegeben wird.
Parameter:
setMaxRetryWaitTimeInSeconds
public void setMaxRetryWaitTimeInSeconds(int maxRetryWaitTimeInSeconds)
Legt die maximale Wiederholungszeit in Sekunden fest.
Wenn eine Anforderung aufgrund eines Drosselungsfehlers fehlschlägt, sendet der Dienst eine Antwort zurück, die einen Wert enthält, der angibt, dass der Client vor Ablauf des Zeitraums keine Wiederholungen ausführen sollte (Wiederholungs-Nach). Mit dem Flag MaxRetryWaitTime kann die Anwendung eine maximale Wartezeit für alle Wiederholungsversuche festlegen. Wenn die kumulative Wartezeit die MaxRetryWaitTime überschreitet, beendet das SDK die Wiederholung und gibt den Fehler an die Anwendung zurück.
Der Standardwert ist 30 Sekunden.
Parameter:
toString
public String toString()
Gilt für:
Azure SDK for Java