Enum CallError 

pub enum CallError<E> {
    Service(ServiceFailure<E>),
    UnknownRemote(UnknownRemote),
    Transport(TransportFailure),
    Protocol(ProtocolFailure),
    Internal {
        source: Box<dyn Error + Send + Sync>,
        error_instance_id: String,
    },
}

A service call failure, independent of local or HTTP dispatch.

Variants

Service(ServiceFailure<E>)

A well-formed service error returned locally or by an HTTP peer.

UnknownRemote(UnknownRemote)

A non-successful HTTP response without a valid service envelope.

Transport(TransportFailure)

The transport failed before completing a service response.

Protocol(ProtocolFailure)

A complete response did not satisfy the service wire contract.

Internal

The local implementation encountered an undeclared failure.

Fields

source: Box<dyn Error + Send + Sync>

Underlying failure retained for server diagnostics.

error_instance_id: String

Correlation identity returned to callers and emitted in server logs.

Implementations

impl<E> CallError<E>

pub fn transport(error: impl Into<Box<dyn Error + Send + Sync>>) -> CallError<E>

Preserve a transport failure that occurred before response headers arrived.

pub fn transport_response( status: u16, error: impl Into<Box<dyn Error + Send + Sync>>, ) -> CallError<E>

Preserve a transport failure that occurred after response headers arrived.

pub fn protocol(message: impl Into<String>) -> CallError<E>

Record a malformed request configuration or response without observed headers.

pub fn protocol_response( status: u16, message: impl Into<String>, ) -> CallError<E>

Record a response that violated the wire contract.

pub fn unknown_remote( status: u16, content_type: Option<String>, body: Vec<u8>, truncated: bool, ) -> CallError<E>

Preserve a non-successful HTTP response without a valid error envelope.

pub fn unreadable_remote( status: u16, content_type: Option<String>, body: Vec<u8>, error: impl Into<Box<dyn Error + Send + Sync>>, ) -> CallError<E>

Preserve a failed error-body read together with response information received first.

pub fn service(envelope: ErrorEnvelope) -> CallError<E>

Create a well-formed locally-raised error outside the declared error set.

pub fn internal(error: impl Into<Box<dyn Error + Send + Sync>>) -> CallError<E>

Preserve an underlying local failure with a new correlation identity.

pub fn unauthenticated() -> CallError<E>

Construct the shared missing-or-invalid-credentials error.

pub fn permission_denied( operation: impl Into<String>, resource: impl Into<String>, ) -> CallError<E>

Construct the shared authorization-denial error.

pub fn error_instance_id(&self) -> Option<&str>

Return the correlation identity carried by a service or internal error.

pub fn from_dependency<F>(error: CallError<F>) -> CallError<E>

where F: Send + Sync + 'static,

Propagate caller authentication failures and hide every other dependency failure.

Trait Implementations

impl<E> Debug for CallError<E>

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

Formats the value using the given formatter.

impl<E> Display for CallError<E>

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

Formats the value using the given formatter.

impl<E> Error for CallError<E>

where E: Send + Sync + 'static,

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<CallError<AppsError>> for Error

fn from(error: CallError<AppsError>) -> Self

Converts to this type from the input type.

impl From<CallError<AuthnError>> for Error

fn from(error: CallError<AuthnError>) -> Self

Converts to this type from the input type.

impl From<CallError<AuthorizationError>> for Error

fn from(error: CallError<AuthorizationError>) -> Self

Converts to this type from the input type.

impl From<CallError<CatalogError>> for Error

fn from(error: CallError<CatalogError>) -> Self

Converts to this type from the input type.

impl From<CallError<ConnectionsError>> for Error

fn from(error: CallError<ConnectionsError>) -> Self

Converts to this type from the input type.

impl From<CallError<EnrichmentsError>> for Error

fn from(error: CallError<EnrichmentsError>) -> Self

Converts to this type from the input type.

impl From<CallError<LocationsError>> for Error

fn from(error: CallError<LocationsError>) -> Self

Converts to this type from the input type.

impl From<CallError<OrganizationError>> for Error

fn from(error: CallError<OrganizationError>) -> Self

Converts to this type from the input type.

impl From<CallError<ProjectError>> for Error

fn from(error: CallError<ProjectError>) -> Self

Converts to this type from the input type.

impl From<CallError<StorageError>> for Error

fn from(error: CallError<StorageError>) -> Self

Converts to this type from the input type.

impl From<CallError<TablesError>> for Error

fn from(error: CallError<TablesError>) -> Self

Converts to this type from the input type.

impl From<CallError<TasksError>> for Error

fn from(error: CallError<TasksError>) -> Self

Converts to this type from the input type.

impl From<CallError<TasksError>> for TaskWaitError

fn from(source: CallError<TasksError>) -> Self

Converts to this type from the input type.

impl From<CallError<UsageError>> for Error

fn from(error: CallError<UsageError>) -> Self

Converts to this type from the input type.

impl From<CallError<VectorIndexesError>> for Error

fn from(error: CallError<VectorIndexesError>) -> Self

Converts to this type from the input type.

impl From<CallError<WorkersError>> for Error

fn from(error: CallError<WorkersError>) -> Self

Converts to this type from the input type.

impl From<CallError<WorkloadsError>> for Error

fn from(error: CallError<WorkloadsError>) -> Self

Converts to this type from the input type.

impl<E> From<E> for CallError<E>

where E: ServiceError,

fn from(error: E) -> CallError<E>

Converts to this type from the input type.