Enum ErrorKind 

pub enum ErrorKind {
    Unexpected,
    InvalidArg,
    Retryable,
    Credentials,
    Protocol,
    BuildWedged,
    LaunchDied,
    WindowClosed,
    Platform,
    Timeout,
    Interrupted,
    Precondition,
    ExecFailed,
}

The coarse failure classes, one per non-zero row of the CLI’s exit table.

These categories are mapped to stable process exit codes by the CLI. The integer exit code lives in the CLI, not here: a library that owned process exit codes would be a library with an opinion about being a process.

Variants

Unexpected

No handler claimed this — a bug in this crate, not the platform.

InvalidArg

Refused locally, before any AWS call. Every trap closure lands here.

Retryable

Transient. Run the identical request again.

Credentials

An identity is wrong or absent; waiting will not fix it.

Protocol

The daemon rejected the request on its merits.

BuildWedged

The image build was never scheduled — the clientToken replay signature.

LaunchDied

The MicroVM reached a terminal state before RUNNING; read stateReason.

WindowClosed

The MicroVM ended before the resume (the suspended window, the maximum duration, or a terminate), and it can’t be resumed; launch a new one. The service refused the resume, and GetMicrovm reports the VM TERMINATING or TERMINATED.

Platform

A control-plane failure with no more specific class.

Timeout

A client-side deadline elapsed. The VM and the exec are untouched.

Interrupted

Interrupted after launch; teardown ran and any leak is named in the payload.

Precondition

A prerequisite is missing.

ExecFailed

The sandbox worked and the command in it exited non-zero.

Its own class because it is the one failure that means nothing is wrong with the platform, the credentials, or this client — a CI caller needs to tell “your tests failed” from “we never got a VM”, and one shared class cannot say both.

Implementations

impl ErrorKind

pub const ALL: [ErrorKind; 13]

Every kind, in exit-code order.

Public so a binding can enumerate the catalog and a test can assert the mapping is total rather than sampling it.

pub fn retryable(self) -> bool

Whether a failure of this kind could plausibly succeed on an identical retry.

The one answer Error::retryable reads, public so a binding that carries only the code across its boundary (the TypeScript one) asks this rather than keeping a list of retryable codes of its own.

pub fn code(self) -> &'static str

The ERR_* string, byte-identical to cli.py’s Code member.

A string beside the eventual integer because the two are read by different consumers: a shell branches on $?, an agent parsing --json branches on code and should never have to keep an integer table.

Trait Implementations

impl Clone for ErrorKind

fn clone(&self) -> ErrorKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorKind

impl Debug for ErrorKind

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

Formats the value using the given formatter.

impl Display for ErrorKind

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

Formats the value using the given formatter.

impl Eq for ErrorKind

impl Hash for ErrorKind

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ErrorKind

fn eq(&self, other: &ErrorKind) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ErrorKind