Enum SubRequestError 

#[non_exhaustive]
pub enum SubRequestError {
    InvalidRequest(String),
    AdmissionTimeout {
        max_connections: usize,
    },
    Connect(String),
    Io(String),
    DeadlineExceeded,
    StreamIdleTimeout {
        idle_timeout: Duration,
    },
    CircuitOpen {
        peer: String,
    },
    ResponseTooLarge {
        actual: usize,
        limit: usize,
    },
}

Errors from sub-request execution.

Typed so callers can map transport failures to appropriate HTTP status codes without inspecting error strings.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidRequest(String)

Failed to construct a valid request (bad headers, URI, etc.).

AdmissionTimeout

The concurrency admission semaphore timed out before a slot became available.

Fields

max_connections: usize

Configured concurrency limit.

Connect(String)

Failed to connect to the upstream.

Io(String)

Failed to write the request or read the response.

DeadlineExceeded

The overall deadline expired.

StreamIdleTimeout

The upstream stopped sending data for longer than the idle timeout.

Fields

idle_timeout: Duration

The configured idle timeout that was exceeded.

CircuitOpen

The circuit breaker for the target peer is open.

Fields

peer: String

Peer address whose circuit is open.

ResponseTooLarge

Response body exceeded the size limit.

Fields

actual: usize

Actual bytes received before truncation.

limit: usize

Configured limit.

Trait Implementations

impl Debug for SubRequestError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for SubRequestError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for SubRequestError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.