Enum HttpClientError 

#[non_exhaustive]
pub enum HttpClientError {
    Build {
        source: Error,
    },
    TlsCertificateAuthoritiesInvalid {
        source: Error,
    },
    TlsCertificateAuthoritiesEmpty,
    TlsNoTrustAnchors,
    TlsClientCertificateChainInvalid {
        source: Error,
    },
    TlsClientCertificateChainEmpty,
    TlsClientKeyInvalid {
        source: Error,
    },
    TlsClientKeyMissing,
    TlsClientKeyEncrypted,
    TlsClientAuth {
        source: Error,
    },
    InvalidUri {
        source: Error,
    },
    ConnectionTimeout,
    Transport {
        source: BoxError,
    },
    Handshake {
        source: Error,
    },
    Request {
        source: Error,
    },
    ProxyTunnel {
        status: StatusCode,
    },
    InvalidConfig {
        source: ValidationErrors,
    },
    InvalidUnixSocketPath {
        source: FromHexError,
    },
    NonUtf8UnixSocketPath {
        source: FromUtf8Error,
    },
    UnsupportedScheme {
        scheme: String,
    },
}

Errors produced by the HTTP client.

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.

Build

The HTTP client could not be constructed.

Fields

source: Error

The underlying error.

TlsCertificateAuthoritiesInvalid

tls.certificate_authorities could not be parsed as PEM.

Fields

source: Error

The underlying error.

TlsCertificateAuthoritiesEmpty

tls.certificate_authorities contained no PEM certificate blocks.

TlsNoTrustAnchors

TLS verification is enabled but no trust anchors are configured.

TlsClientCertificateChainInvalid

tls.client_authentication.certificate_chain could not be parsed as PEM.

Fields

source: Error

The underlying error.

TlsClientCertificateChainEmpty

tls.client_authentication.certificate_chain contained no certificates.

TlsClientKeyInvalid

tls.client_authentication.key could not be parsed as PEM.

Fields

source: Error

The underlying error.

TlsClientKeyMissing

tls.client_authentication.key contained no recognised private key block.

TlsClientKeyEncrypted

tls.client_authentication.key is encrypted. Encrypted keys are not supported.

TlsClientAuth

tls.client_authentication was rejected by rustls — typically because the private key is not usable as a TLS signer or does not match the leaf certificate’s public key.

Cert/key pair mismatches that pass the build but fail the handshake surface as Transport.

Fields

source: Error

The underlying error.

InvalidUri

The request URI could not be constructed from its components.

Fields

source: Error

The underlying error.

ConnectionTimeout

The connection timed out before being established.

Transport

A TCP or TLS transport error.

Fields

source: BoxError

The underlying error.

Handshake

The HTTP/1.1 or HTTP/2 handshake failed.

Fields

source: Error

The underlying error.

Request

Sending or receiving the HTTP request failed.

Fields

source: Error

The underlying error.

ProxyTunnel

The proxy returned a non-200 response to a CONNECT request.

Fields

status: StatusCode

The HTTP status code returned by the proxy.

InvalidConfig

The configuration failed validation.

apollo_configuration::parse_yaml runs validation before returning, so this only fires when the config reached HttpClient::new through a path that bypassed it.

Fields

source: ValidationErrors

The collected validation errors.

InvalidUnixSocketPath

A unix:// URI’s authority could not be hex-decoded into a socket path.

Fields

source: FromHexError

The underlying decoding error.

NonUtf8UnixSocketPath

A unix:// URI’s authority decoded to bytes that are not valid UTF-8.

Non-UTF-8 socket paths are not supported.

Fields

source: FromUtf8Error

The underlying UTF-8 decoding error.

UnsupportedScheme

The request URI’s scheme is not supported on this platform.

Fields

scheme: String

The scheme from the request URI.

Trait Implementations

impl Debug for HttpClientError

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

Formats the value using the given formatter.

impl Diagnostic for HttpClientError

fn code(&self) -> Option<Box<dyn Display + '_>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn help<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn url<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn related<'a>( &'a self, ) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>>

Additional related Diagnostics.

fn diagnostic_source(&self) -> Option<&dyn Diagnostic>

The cause of the error.

impl Display for HttpClientError

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

Formats the value using the given formatter.

impl Error for HttpClientError

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.

impl Error for HttpClientError

fn to_json(&self, config: FormatConfig) -> Result<Value, Error>

Render this error as JSON format

fn to_html(&self, config: FormatConfig) -> String

Render this error as HTML

fn to_graphql(&self, config: FormatConfig) -> Result<Value, Error>

Render this error as GraphQL JSON format

fn to_text(&self, config: FormatConfig) -> String

Render this error as plain text

fn to_jsonrpc(&self, config: FormatConfig) -> Result<Value, Error>

Render this error as JSON-RPC 2.0 error format

fn http_status(&self) -> StatusCode

Get the HTTP status code for this error

fn http_headers(&self) -> Vec<(HeaderName, HeaderValue)>

Get HTTP headers that should be returned with this error

fn to_debug(&self) -> String

where Self: Debug,

Render this error in debug format using Rust’s standard Debug output.

impl From<Error> for HttpClientError

fn from(source: Error) -> Self

Converts to this type from the input type.