Enum ApiError

#[non_exhaustive]
pub enum ApiError<E>
where
    E: Error + Send + Sync + 'static,
{
    Client {
        source: E,
    },
    UrlParse {
        source: ParseError,
    },
    Body {
        source: BodyError,
    },
    Json {
        source: Error,
    },
    ResourceNotFound,
    IdNotUnique,
    Session {
        msg: String,
    },
    OpenStack {
        status: StatusCode,
        uri: Uri,
        msg: String,
    },
    OpenStackService {
        status: StatusCode,
        uri: Uri,
        data: String,
    },
    OpenStackUnrecognized {
        status: StatusCode,
        uri: Uri,
        obj: Value,
    },
    DataType {
        source: Error,
        typename: &'static str,
    },
    Pagination {
        source: PaginationError,
    },
    Catalog {
        source: CatalogError,
    },
}

Errors which may occur when using API endpoints.

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.

Client

The client encountered an error.

Fields

source: E

The client error.

UrlParse

The URL failed to parse.

Fields

source: ParseError

The source of the error.

Body

Body data could not be created.

Fields

source: BodyError

The source of the error.

Json

JSON deserialization from OpenStack failed.

Fields

source: Error

The source of the error.

ResourceNotFound

Resource can not be found using known locations.

IdNotUnique

Too many candidates to identitfy resource by identifier

Session

OpenStack session error.

Fields

msg: String

The error message from OpenStack.

OpenStack

OpenStack returned understandable error message

Fields

status: StatusCode

The status code for the return.

uri: Uri

The URI of the request

msg: String

The error message from OpenStack.

OpenStackService

OpenStack returned an error without JSON information.

Fields

status: StatusCode

The status code for the return.

uri: Uri

The URI of the request

data: String

The error data from OpenStack.

OpenStackUnrecognized

OpenStack returned an HTTP error with JSON we did not recognize.

Fields

status: StatusCode

The status code for the return.

uri: Uri

The URI of the request

obj: Value

The full object from OpenStack.

DataType

Failed to parse an expected data type from JSON.

Fields

source: Error

The source of the error.

typename: &'static str

The name of the type that could not be deserialized.

Pagination

An error with pagination occurred.

Fields

source: PaginationError

The source of the error.

Catalog

Fields

source: CatalogError

The source of the error.

Implementations

impl<E> ApiError<E>

where E: Error + Send + Sync + 'static,

pub fn client(source: E) -> Self

Create an API error in a client error.

pub fn catalog(source: CatalogError) -> Self

Create an API error in a catalog error.

Trait Implementations

impl<E> Debug for ApiError<E>

where E: Error + Send + Sync + 'static + Debug,

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

Formats the value using the given formatter.

impl<E> Display for ApiError<E>

where E: Error + Send + Sync + 'static,

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

Formats the value using the given formatter.

impl<E> Error for ApiError<E>

where E: Error + Send + Sync + 'static + Error, Self: Debug + Display,

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<ApiError<RestError>> for OpenStackError

fn from(source: ApiError<RestError>) -> Self

Converts to this type from the input type.

impl<E> From<BodyError> for ApiError<E>

where E: Error + Send + Sync + 'static,

fn from(source: BodyError) -> Self

Converts to this type from the input type.

impl<E> From<CatalogError> for ApiError<E>

where E: Error + Send + Sync + 'static,

fn from(source: CatalogError) -> Self

Converts to this type from the input type.

impl<E> From<Error> for ApiError<E>

where E: Error + Send + Sync + 'static,

fn from(source: Error) -> Self

Converts to this type from the input type.

impl<E> From<PaginationError> for ApiError<E>

where E: Error + Send + Sync + 'static,

fn from(source: PaginationError) -> Self

Converts to this type from the input type.

impl<E> From<ParseError> for ApiError<E>

where E: Error + Send + Sync + 'static,

fn from(source: ParseError) -> Self

Converts to this type from the input type.