Enum AdminError 

pub enum AdminError {
    Http(Error),
    Status {
        method: String,
        url: String,
        code: u16,
        body: String,
    },
    Decode {
        method: String,
        url: String,
        status: u16,
        content_type: String,
        snippet: String,
        source: Error,
    },
    Json(Error),
    Url(ParseError),
    Builder(String),
    Auth(String),
    InvalidName(String),
    Protocol(String),
}

Errors returned by the admin client.

Variants

Http(Error)

Transport-layer error from reqwest.

Status

API returned a non-success HTTP status.

method and url identify the exact request that failed, so an operator can tell at a glance whether they hit the wrong endpoint, cluster, or proxy without re-deriving the URL from the call site.

Fields

method: String

HTTP method of the failed request (GET, POST, …).

url: String

Full request URL the client dispatched.

code: u16

HTTP status code.

body: String

Response body (or a placeholder if reading the body failed).

Decode

A 2xx response body could not be decoded as the expected JSON.

Carries the request method + url, the HTTP status, the response content_type, and a truncated body snippet so the failure is self-diagnosing: a text/html body or an empty <none> content-type on a 200 almost always means the request was answered by the wrong endpoint, a reverse proxy, or an auth redirect rather than the broker’s admin API. Replaces the bare serde_json “expected value at line 1 column 1” message.

Fields

method: String

HTTP method of the request whose response failed to decode.

url: String

Full request URL the client dispatched.

status: u16

HTTP status code of the response (always 2xx here).

content_type: String

Response Content-Type header, or <none> when absent.

snippet: String

First ~256 bytes of the body (UTF-8 lossy), truncated with an ellipsis marker when longer.

source: Error

The underlying serde decode error.

Json(Error)

JSON encode error — building a request body from a Rust value.

Response-decode failures surface as AdminError::Decode; this variant covers the rare serialization-side failure (e.g. build_url_config_multipart).

Url(ParseError)

URL parse / construction error.

Builder(String)

Builder configuration error (missing service URL, invalid argument…).

Auth(String)

Authentication failure — e.g. the OAuth2 client_credentials exchange failed or returned an empty access token.

InvalidName(String)

Caller passed a namespace or topic name that the client could not parse.

Protocol(String)

Broker returned a response that violates the documented wire contract (e.g. negative ledgerId from getMessageIdByIndex, which Java MessageIdImpl cannot represent either).

Trait Implementations

impl Debug for AdminError

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

Formats the value using the given formatter.

impl Display for AdminError

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

Formats the value using the given formatter.

impl Error for AdminError

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<Error> for AdminError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AdminError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for AdminError

fn from(source: ParseError) -> Self

Converts to this type from the input type.