FallbackTriggers¶
Structure Class¶
FallbackTriggers
dataclass
¶
Bases: _SerdeShape
The conditions that trigger a fallback to the next target. A fallback occurs if the response matches any of the specified status codes or errors.
Attributes¶
errors
class-attribute
instance-attribute
¶
The errors that trigger a fallback. You can specify the following:
-
CONNECTION_ERROR-- The gateway couldn't connect to the target because the connection was refused, reset, or timed out. The request didn't reach the target. -
FIRST_BYTE_TIMEOUT-- The target accepted the connection but didn't return the first byte of the response withinfirstByteTimeoutMilliseconds. The gateway abandons the request before any of the response reaches you. -
UNROUTABLE-- The gateway couldn't route the request to the target, for example because the target doesn't exist or doesn't support the request path. These errors don't count toward the circuit breaker.
status_codes
class-attribute
instance-attribute
¶
The HTTP status codes returned by the target that trigger a fallback. You can specify the following:
-
An exact status code -- A three-digit code, such as
429. -
A class of status codes -- The first digit followed by
XX, such as5XX, which matches every code from 500 to 599.
Only 4XX and 5XX codes are supported. Throttling by the gateway itself doesn't trigger a fallback.