Enum InstanceError 

pub enum InstanceError {
    Bind9InstanceUnavailable {
        endpoint: String,
        status_code: u16,
    },
    HttpConnectionFailed {
        endpoint: String,
        reason: String,
    },
    HttpRequestTimeout {
        endpoint: String,
        timeout_ms: u64,
    },
    UnexpectedHttpResponse {
        endpoint: String,
        status_code: u16,
        reason: String,
    },
}

Errors related to BIND9 instance availability and connectivity.

These errors occur when the Bindcar HTTP API is unreachable or returns gateway errors, indicating the BIND9 instance or bindcar service is unavailable.

Variants

Bind9InstanceUnavailable

BIND9 instance unavailable (HTTP 502 Bad Gateway or 503 Service Unavailable)

Returned when the bindcar HTTP API returns a gateway error, indicating the underlying BIND9 instance is not responding or the bindcar process cannot communicate with BIND9.

Fields

endpoint: String

The endpoint (IP:port) that is unavailable

status_code: u16

HTTP status code (502 or 503)

HttpConnectionFailed

HTTP connection failed (network unreachable, connection refused, timeout)

Returned when the HTTP client cannot establish a connection to the bindcar API. This indicates network issues, the pod being down, or the service not listening.

Fields

endpoint: String

The endpoint (IP:port) that couldn’t be reached

reason: String

Reason for the connection failure

HttpRequestTimeout

HTTP request timeout

Returned when an HTTP request to bindcar exceeds the configured timeout. This typically indicates a heavily loaded or unresponsive BIND9 instance.

Fields

endpoint: String

The endpoint (IP:port) that timed out

timeout_ms: u64

Timeout duration in milliseconds

UnexpectedHttpResponse

Unexpected HTTP response from bindcar API

Returned when bindcar returns an unexpected HTTP status code that doesn’t map to a known error condition.

Fields

endpoint: String

The endpoint that returned the unexpected response

status_code: u16

HTTP status code

reason: String

Response body or error message

Trait Implementations

impl Clone for InstanceError

fn clone(&self) -> InstanceError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InstanceError

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

Formats the value using the given formatter.

impl Display for InstanceError

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

Formats the value using the given formatter.

impl Error for InstanceError

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 From<InstanceError> for DnsError

fn from(source: InstanceError) -> Self

Converts to this type from the input type.