Enum Error 

pub enum Error {
    Connect {
        socket: String,
        source: Error,
    },
    RequestTimeout {
        method: String,
        path: String,
        timeout: Duration,
    },
    Api {
        method: String,
        path: String,
        status: u16,
        message: String,
    },
    OperationTimeout {
        step: String,
        operation: String,
        status: String,
        waited: Duration,
        cancelled: bool,
    },
    OperationFailed {
        step: String,
        message: String,
    },
    NotReady {
        sandbox: String,
        check: String,
        detail: String,
        waited: Duration,
    },
    ExecTimeout {
        argv: String,
        timeout: Duration,
    },
    NotFound(String),
    AlreadyExists(String),
    Invalid(String),
    Forbidden(String),
    Interpolation(String),
    Parse {
        path: String,
        message: String,
    },
    WebSocket(String),
    Protocol(String),
    Remote {
        code: String,
        message: String,
        data: Value,
    },
    Io(Error),
    Json(Error),
}

Everything isb can fail with.

Variants

Connect

Could not reach incusd at all (socket missing, permission denied, refused).

Fields

socket: String

source: Error

RequestTimeout

A single HTTP request to incusd did not complete within its socket timeout.

Fields

method: String

path: String

timeout: Duration

Api

incusd answered with an error response.

Fields

method: String

path: String

status: u16

message: String

OperationTimeout

A background operation ran past its deadline. step names what isb was doing (“create instance”, “start instance”, …), so a stall is reported as the step that stalled rather than as a bare hang.

Fields

step: String

operation: String

status: String

waited: Duration

cancelled: bool

OperationFailed

A background operation finished unsuccessfully.

Fields

step: String

message: String

NotReady

A readiness check did not pass before its deadline.

Fields

sandbox: String

check: String

detail: String

waited: Duration

ExecTimeout

An exec with an explicit timeout ran past it; the process was sent SIGKILL.

Fields

argv: String

timeout: Duration

NotFound(String)

AlreadyExists(String)

Invalid(String)

The spec, the compose file or an argument is invalid.

Forbidden(String)

The caller may not do this (another org’s resources, a platform-only tool, or no isb account).

Interpolation(String)

Variable interpolation failed (unset variable, ${VAR:?message}, bad syntax).

Parse

Fields

path: String

message: String

WebSocket(String)

Protocol(String)

Remote

A tool called through isb serve failed. code and data are the fields of the server-side error’s crate::rpc::error_json.

Fields

code: String

message: String

data: Value

Io(Error)

Json(Error)

Implementations

impl Error

pub fn is_not_found(&self) -> bool

True for an incusd “not found” answer.

pub fn is_conflict(&self) -> bool

True for an incusd conflict (the object already exists).

pub fn is_timeout(&self) -> bool

True when the error is a deadline, either on a request or an operation.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.