Share via


ConnectionRetryPolicy Osztály

Öröklődés
azure.core.pipeline.policies._retry.RetryPolicy
ConnectionRetryPolicy

Konstruktor

ConnectionRetryPolicy(**kwargs)

Metódusok

configure_retries

Konfigurálja az újrapróbálkozások beállításait.

get_backoff_time

Az aktuális visszalépési időt adja vissza.

get_retry_after

A Retry-After értékét másodpercben lekérheti.

increment

Növelje az újrapróbálkozások számlálóit.

is_exhausted

Ellenőrzi, hogy maradt-e újrapróbálkozás.

is_retry

Ellenőrzi, hogy a metódus/állapotkód újrapróbálható-e.

Az engedélyezési listák és vezérlőváltozók, például az összes újrapróbálkozások száma alapján, hogy figyelembe kell-e venni a Retry-After fejlécet, szerepel-e ez a fejléc, és hogy a visszaadott állapotkód szerepel-e azon állapotkódok listáján, amelyekre a fent említett fejléc jelenlétekor újra kell próbálkozni.

A viselkedés a következő:

  •   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

Tiltsa le az újrapróbálkozásokat.

parse_retry_after

Segéd a Retry-After elemzéséhez és az érték másodpercben történő lekéréséhez.

send

Elküldi a PipelineRequest objektumot a következő szabályzatnak. Szükség esetén újrapróbálkozást használ. Emellett egy abszolút ügyféloldali időtúllépést is kényszerít, amely több újrapróbálkozási kísérletre is kiterjed.

sleep

Alvó állapot az újrapróbálkozási kísérletek között.

Ez a módszer figyelembe veszi a kiszolgáló válaszfejlécét Retry-After , és a kért idő időtartamát alvó állapotban tartja. Ha ez nem jelenik meg, exponenciális visszalépést fog használni. Alapértelmezés szerint a visszalépési tényező 0, és ez a metódus azonnal visszatér.

update_context

Frissítések újrapróbálkozás előzményeit folyamatkörnyezetben.

configure_retries

Konfigurálja az újrapróbálkozások beállításait.

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

Paraméterek

Name Description
options
Kötelező

kulcsszóargumentumok a környezetből.

Válaszok

Típus Description

Az újrapróbálkozások beállításait és előzményeit tartalmazó diktálás.

get_backoff_time

Az aktuális visszalépési időt adja vissza.

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

Paraméterek

Name Description
settings
Kötelező

Az újrapróbálkozás beállításai.

Válaszok

Típus Description

Az aktuális visszalépési érték.

get_retry_after

A Retry-After értékét másodpercben lekérheti.

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

Paraméterek

Name Description
response
Kötelező

A PipelineResponse objektum

Válaszok

Típus Description

A Retry-After értéke másodpercben.

increment

Növelje az újrapróbálkozások számlálóit.

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

Paraméterek

Name Description
settings
Kötelező

Az újrapróbálkozás beállításai.

response

Egy folyamat válaszobjektuma.

alapértelmezett érték: None
error

Hiba történt a kérés során, vagy Nincs, ha a válasz sikeresen érkezett.

alapértelmezett érték: None

Válaszok

Típus Description

Az, hogy van-e újrapróbálkozási kísérlet true (Igaz), ha több újrapróbálkozási kísérlet érhető el, Hamis egyéb esetben

is_exhausted

Ellenőrzi, hogy maradt-e újrapróbálkozás.

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

Paraméterek

Name Description
settings
Kötelező

az újrapróbálkozás beállításai

Válaszok

Típus Description

Hamis, ha több újrapróbálkozások vannak. Igaz, ha az újrapróbálkozások elfogytak.

is_retry

Ellenőrzi, hogy a metódus/állapotkód újrapróbálható-e.

Az engedélyezési listák és vezérlőváltozók, például az összes újrapróbálkozások száma alapján, hogy figyelembe kell-e venni a Retry-After fejlécet, szerepel-e ez a fejléc, és hogy a visszaadott állapotkód szerepel-e azon állapotkódok listáján, amelyekre a fent említett fejléc jelenlétekor újra kell próbálkozni.

A viselkedés a következő:

  •   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

Paraméterek

Name Description
settings
Kötelező

Az újrapróbálkozás beállításai.

response
Kötelező

A PipelineResponse objektum

Válaszok

Típus Description

Igaz, ha a metódus/állapotkód újrapróbálható. Hamis, ha nem újrapróbálható.

no_retries

Tiltsa le az újrapróbálkozásokat.

no_retries() -> ClsRetryPolicy

Válaszok

Típus Description

Újrapróbálkozásra vonatkozó szabályzat, amelynek az újrapróbálkozások le vannak tiltva.

parse_retry_after

Segéd a Retry-After elemzéséhez és az érték másodpercben történő lekéréséhez.

parse_retry_after(retry_after: str) -> float

Paraméterek

Name Description
retry_after
Kötelező
str

Retry-After fejléc

Válaszok

Típus Description

A Retry-After értéke másodpercben.

send

Elküldi a PipelineRequest objektumot a következő szabályzatnak. Szükség esetén újrapróbálkozást használ. Emellett egy abszolút ügyféloldali időtúllépést is kényszerít, amely több újrapróbálkozási kísérletre is kiterjed.

send(request)

Paraméterek

Name Description
request
Kötelező

A PipelineRequest objektum

Válaszok

Típus Description

Visszaadja a PipelineResponse értéket, vagy hibát jelez, ha túllépte a maximális újrapróbálkozások értékét.

Kivételek

Típus Description

Az újrapróbálkozások maximális száma túllépve.

A megadott időtúllépés túllépve.

A hitelesítés sikertelen.

sleep

Alvó állapot az újrapróbálkozási kísérletek között.

Ez a módszer figyelembe veszi a kiszolgáló válaszfejlécét Retry-After , és a kért idő időtartamát alvó állapotban tartja. Ha ez nem jelenik meg, exponenciális visszalépést fog használni. Alapértelmezés szerint a visszalépési tényező 0, és ez a metódus azonnal visszatér.

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

Paraméterek

Name Description
settings
Kötelező

Az újrapróbálkozás beállításai.

transport
Kötelező

A HTTP-átviteli típus.

response

A PipelineResponse objektum.

alapértelmezett érték: None

update_context

Frissítések újrapróbálkozás előzményeit folyamatkörnyezetben.

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

Paraméterek

Name Description
context
Kötelező

A folyamatkörnyezet.

retry_settings
Kötelező

Az újrapróbálkozás beállításai.

Attribútumok

BACKOFF_MAX

Maximális visszalépési idő.

BACKOFF_MAX = 120

next

Mutasson a következő szabályzatra vagy egy átvitelre (házirendként burkolva). A folyamat létrehozásakor lesz beállítva.

next: HTTPPolicy[HTTPRequestType, HTTPResponseType]