Enum SpawnError 

pub enum SpawnError {
    RuntimeUnavailable,
    RegionNotFound(RegionId),
    RegionClosed(RegionId),
    LocalSchedulerUnavailable,
    NameRegistrationFailed {
        name: String,
        reason: String,
    },
    RegionAtCapacity {
        region: RegionId,
        limit: usize,
        live: usize,
    },
    AuthorizationDenied {
        region: RegionId,
        cx_id: String,
    },
    AdmissionSlotAlreadyReserved {
        task_id: TaskId,
    },
}

Errors that can occur when spawning a task.

Variants

RuntimeUnavailable

The runtime backing a weak handle has already been dropped.

RegionNotFound(RegionId)

The target region does not exist.

RegionClosed(RegionId)

The target region is closed or draining and cannot accept new tasks.

LocalSchedulerUnavailable

Local spawn attempted without an active worker-local scheduler.

NameRegistrationFailed

Named service registration failed during spawn.

Fields

name: String

The attempted service name.

reason: String

Deterministic failure reason.

RegionAtCapacity

The target region has reached its admission limit.

Fields

region: RegionId

The region that rejected the spawn.

limit: usize

The configured admission limit.

live: usize

The number of live tasks at the time of rejection.

AuthorizationDenied

Authorization failed: caller lacks permission to create tasks in the target region.

Fields

region: RegionId

The region that denied access.

cx_id: String

The capability context that was checked.

AdmissionSlotAlreadyReserved

The one-shot canonical-identity slot was already reserved by another spawn request.

Fields

task_id: TaskId

Provisional mailbox identity of the rejected request.

Implementations

impl SpawnError

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

Returns the stable machine-readable error code for this variant.

Codes are allocated from the ASUP-E00x range (core runtime spawn errors) of the asupersync error-code registry and are stable across releases: agents and tooling may match on them. The same code is embedded as the leading [ASUP-ENNN] token of the Display rendering.

Trait Implementations

impl Clone for SpawnError

fn clone(&self) -> SpawnError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpawnError

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

Formats the value using the given formatter.

impl Display for SpawnError

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

Formats the value using the given formatter.

impl Eq for SpawnError

impl Error for SpawnError

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 PartialEq for SpawnError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SpawnError