ConnectionRetryPolicy Klasse

Vererbung

azure.core.pipeline.policies._retry.RetryPolicy

ConnectionRetryPolicy

Konstruktor

ConnectionRetryPolicy(**kwargs)

Methoden

configure_retries	Konfiguriert die Wiederholungseinstellungen.
get_backoff_time	Gibt die aktuelle Backoffzeit zurück.
get_retry_after	Rufen Sie den Wert von Retry-After in Sekunden ab.
increment	Erhöhen Sie die Wiederholungsindikatoren.
is_exhausted	Überprüft, ob wiederholungsversuche noch vorhanden sind.
is_retry	Überprüft, ob methoden-/status Code wiederholt werden kann. Basierend auf Zulassungslisten und Steuerungsvariablen, z. B. der Anzahl der zuzulassenden Wiederholungen, ob der Retry-After-Header berücksichtigt werden soll, ob dieser Header vorhanden ist und ob sich der zurückgegebene status Code in der Liste der status Codes befindet, die bei Vorhandensein des oben genannten Headers wiederholt werden sollen. Das Verhalten ist: If status_code < 400: don't retry Else if Retry-After present: retry Else: retry based on the safe status code list ([408, 429, 500, 502, 503, 504])
no_retries	Deaktivieren Sie Wiederholungsversuche.
parse_retry_after	Hilfsprogramm zum Analysieren Retry-After und Abrufen des Werts in Sekunden.
send	Sendet das PipelineRequest-Objekt an die nächste Richtlinie. Verwendet bei Bedarf Wiederholungseinstellungen. Erzwingt außerdem ein absolutes clientseitiges Timeout, das mehrere Wiederholungsversuche umfasst.
sleep	Ruhezustand zwischen Wiederholungsversuchen. Diese Methode berücksichtigt den Antwortheader eines Retry-After Servers und hält die Dauer der angeforderten Zeit in den Standbymodus. Wenn dies nicht vorhanden ist, wird ein exponentielles Backoff verwendet. Standardmäßig ist der Backofffaktor 0, und diese Methode wird sofort zurückgegeben.
update_context	Updates Wiederholungsverlauf im Pipelinekontext.

configure_retries

Konfiguriert die Wiederholungseinstellungen.

configure_retries(options: Dict[str, Any]) -> Dict[str, Any]

Parameter

Name	Beschreibung
options Erforderlich	dict Schlüsselwort (keyword) Argumente aus dem Kontext.

Gibt zurück

Typ	Beschreibung
dict	Ein Diktat, das Einstellungen und den Verlauf für Wiederholungsversuche enthält.

get_backoff_time

Gibt die aktuelle Backoffzeit zurück.

get_backoff_time(settings: Dict[str, Any]) -> float

Parameter

Name	Beschreibung
settings Erforderlich	dict Die Wiederholungseinstellungen.

Gibt zurück

Typ	Beschreibung
float	Der aktuelle Backoffwert.

get_retry_after

Rufen Sie den Wert von Retry-After in Sekunden ab.

get_retry_after(response: PipelineResponse[Any, AllHttpResponseType]) -> float | None

Parameter

Name	Beschreibung
response Erforderlich	PipelineResponse Das PipelineResponse-Objekt

Gibt zurück

Typ	Beschreibung
float, None	Wert von Retry-After in Sekunden.

increment

Erhöhen Sie die Wiederholungsindikatoren.

increment(settings: Dict[str, Any], response: PipelineRequest[HTTPRequestType] | PipelineResponse[HTTPRequestType, AllHttpResponseType] | None = None, error: Exception | None = None) -> bool

Parameter

Name	Beschreibung
settings Erforderlich	dict Die Wiederholungseinstellungen.
response	PipelineResponse Ein Pipelineantwortobjekt. Standardwert: None
error	AzureError Ein Fehler, der während der Anforderung aufgetreten ist, oder Keine, wenn die Antwort erfolgreich empfangen wurde. Standardwert: None

Gibt zurück

Typ	Beschreibung
bool	Gibt an, ob ein Wiederholungsversuch verfügbar ist True, wenn weitere Wiederholungsversuche verfügbar sind, andernfalls False

is_exhausted

Überprüft, ob wiederholungsversuche noch vorhanden sind.

is_exhausted(settings: Dict[str, Any]) -> bool

Parameter

Name	Beschreibung
settings Erforderlich	dict die Wiederholungseinstellungen

Gibt zurück

Typ	Beschreibung
bool	False, wenn mehr Wiederholungsversuche vorhanden sind. True, wenn Wiederholungsversuche erschöpft sind.

is_retry

Überprüft, ob methoden-/status Code wiederholt werden kann.

Basierend auf Zulassungslisten und Steuerungsvariablen, z. B. der Anzahl der zuzulassenden Wiederholungen, ob der Retry-After-Header berücksichtigt werden soll, ob dieser Header vorhanden ist und ob sich der zurückgegebene status Code in der Liste der status Codes befindet, die bei Vorhandensein des oben genannten Headers wiederholt werden sollen.

Das Verhalten ist:

•   If status_code < 400: don't retry
  

•   Else if Retry-After present: retry
  

•   Else: retry based on the safe status code list ([408, 429, 500, 502, 503, 504])
  

is_retry(settings: Dict[str, Any], response: PipelineResponse[HTTPRequestType, AllHttpResponseType]) -> bool

Parameter

Name	Beschreibung
settings Erforderlich	dict Die Wiederholungseinstellungen.
response Erforderlich	PipelineResponse Das PipelineResponse-Objekt

Gibt zurück

Typ	Beschreibung
bool	True, wenn die Methode/status Code wiederholt werden kann. False, wenn nicht wiederholt werden kann.

no_retries

Deaktivieren Sie Wiederholungsversuche.

no_retries() -> ClsRetryPolicy

Gibt zurück

Typ	Beschreibung
RetryPolicy, AsyncRetryPolicy	Eine Wiederholungsrichtlinie mit deaktivierten Wiederholungsversuchen.

parse_retry_after

Hilfsprogramm zum Analysieren Retry-After und Abrufen des Werts in Sekunden.

parse_retry_after(retry_after: str) -> float

Parameter

Name	Beschreibung
retry_after Erforderlich	str Retry-After-Header

Gibt zurück

Typ	Beschreibung
float	Wert von Retry-After in Sekunden.

send

Sendet das PipelineRequest-Objekt an die nächste Richtlinie. Verwendet bei Bedarf Wiederholungseinstellungen. Erzwingt außerdem ein absolutes clientseitiges Timeout, das mehrere Wiederholungsversuche umfasst.

send(request)

Parameter

Name	Beschreibung
request Erforderlich	PipelineRequest Das PipelineRequest-Objekt

Gibt zurück

Typ	Beschreibung
PipelineResponse	Gibt pipelineResponse zurück oder löst einen Fehler aus, wenn die maximale Anzahl von Wiederholungen überschritten wurde.

Ausnahmen

Typ	Beschreibung
AzureError	Die maximale Anzahl von Wiederholungsversuchen wurde überschritten.
CosmosClientTimeoutError	Das angegebene Timeout wurde überschritten.
ClientAuthenticationError	Die Authentifizierung ist fehlgeschlagen.

sleep

Ruhezustand zwischen Wiederholungsversuchen.

Diese Methode berücksichtigt den Antwortheader eines Retry-After Servers und hält die Dauer der angeforderten Zeit in den Standbymodus. Wenn dies nicht vorhanden ist, wird ein exponentielles Backoff verwendet. Standardmäßig ist der Backofffaktor 0, und diese Methode wird sofort zurückgegeben.

sleep(settings: Dict[str, Any], transport: HttpTransport[HTTPRequestType, HTTPResponseType], response: PipelineResponse[HTTPRequestType, HTTPResponseType] | None = None) -> None

Parameter

Name	Beschreibung
settings Erforderlich	dict Die Wiederholungseinstellungen.
transport Erforderlich	HttpTransport Der HTTP-Transporttyp.
response	PipelineResponse Das PipelineResponse-Objekt. Standardwert: None

update_context

Updates Wiederholungsverlauf im Pipelinekontext.

update_context(context: PipelineContext, retry_settings: Dict[str, Any]) -> None

Parameter

Name	Beschreibung
context Erforderlich	PipelineContext Der Pipelinekontext.
retry_settings Erforderlich	dict Die Wiederholungseinstellungen.

Attribute

BACKOFF_MAX

Maximale Backoffzeit.

BACKOFF_MAX = 120

next

Zeiger auf die nächste Richtlinie oder einen Transport (als Richtlinie umschlossen). Wird bei der Pipelineerstellung festgelegt.

next: HTTPPolicy[HTTPRequestType, HTTPResponseType]