Enum RemoteStoreError 

pub enum RemoteStoreError {
    PreconditionFailed(ConcurrencyConflict),
    PreconditionRequired {
        detail: String,
    },
    IdempotencyConflict {
        reason: String,
    },
    Unauthorized {
        policy: String,
        reason: String,
    },
    NotFound,
    AlreadyExists {
        detail: String,
    },
    InvalidRequest {
        detail: String,
    },
    Conflict {
        detail: String,
    },
    DependentNotFound {
        detail: String,
    },
    HealthGateFailed {
        revision_id: RevisionId,
        failed_checks: Vec<HealthCheckId>,
        message: String,
    },
    IntegrityMismatch {
        expected: String,
        actual: String,
    },
    NotYetImplemented {
        detail: String,
    },
    Internal {
        message: String,
    },
}

Errors a remote store can return, each mapped to its HTTP status so the client and server agree on the contract.

Variants

PreconditionFailed(ConcurrencyConflict)

If-Match/generation precondition failed — 412.

PreconditionRequired

A guarded write pinned no prior state — 428.

Fields

detail: String

IdempotencyConflict

Idempotency key reused with a different request — 409.

Fields

reason: String

Unauthorized

RBAC denied the mutation — 403.

Fields

policy: String

reason: String

NotFound

Resource does not exist — 404.

AlreadyExists

Create-shaped request targeting a resource that already exists — 409. Distinct from RemoteStoreError::IdempotencyConflict (same status): that one is a key-reuse protocol violation, this one is a domain conflict the caller resolves with an update verb instead.

Fields

detail: String

InvalidRequest

Request body failed validation before any state was touched — 400. Covers malformed payloads and key/payload mismatches (e.g. a body whose env_id contradicts the URL).

Fields

detail: String

Conflict

Domain/state conflict that is neither a create-on-existing (RemoteStoreError::AlreadyExists) nor a key-reuse protocol violation (RemoteStoreError::IdempotencyConflict) — 409. E.g. a revision observed in a lifecycle the verb cannot start from, or an archive blocked by live traffic references.

Fields

detail: String

DependentNotFound

The environment exists but a sub-resource the verb references (deployment, revision, slot, …) does not — 404. Distinct from RemoteStoreError::NotFound (the environment itself is missing) so clients can tell “wrong env” from “wrong dependent id”.

Fields

detail: String

HealthGateFailed

The warm/ready health gate rejected the revision — 422. The server has ALREADY persisted the revision’s lifecycle as Failed before returning this (mirror of the local store’s committed-on-error contract); clients must treat the mutation as committed.

Fields

revision_id: RevisionId

failed_checks: Vec<HealthCheckId>

message: String

IntegrityMismatch

Stored state failed its integrity hash — 422.

Fields

expected: String

actual: String

NotYetImplemented

The operation is recognized but not yet implemented — 501.

Fields

detail: String

Internal

Store-internal failure — 500.

Fields

message: String

Implementations

impl RemoteStoreError

pub fn http_status(&self) -> u16

HTTP status code this error maps to.

Trait Implementations

impl Clone for RemoteStoreError

fn clone(&self) -> RemoteStoreError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RemoteStoreError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RemoteStoreError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RemoteStoreError

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

Formats the value using the given formatter.

impl Eq for RemoteStoreError

impl Error for RemoteStoreError

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<PreconditionError> for RemoteStoreError

fn from(err: PreconditionError) -> Self

Converts to this type from the input type.

impl PartialEq for RemoteStoreError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RemoteStoreError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RemoteStoreError