Enum ProxyError 

pub enum ProxyError {
    BucketNotFound(String),
    NoSuchKey(String),
    AccessDenied,
    SignatureDoesNotMatch,
    InvalidRequest(String),
    MissingAuth,
    ExpiredCredentials,
    InvalidOidcToken(String),
    RoleNotFound(String),
    BackendError(String),
    PreconditionFailed,
    NotModified,
    ConfigError(String),
    Internal(String),
}

Central error type for the proxy, mapping each variant to an S3-compatible HTTP response.

Variants

BucketNotFound(String)

The requested virtual bucket does not exist in the registry.

NoSuchKey(String)

The requested object key was not found in the backend store.

AccessDenied

The caller’s identity lacks permission for the requested operation.

SignatureDoesNotMatch

The SigV4 signature in the request does not match the expected value.

InvalidRequest(String)

The request is malformed or contains invalid parameters.

MissingAuth

The request contains no authentication credentials.

ExpiredCredentials

The credentials used to sign the request have expired.

InvalidOidcToken(String)

The OIDC token provided for STS role assumption is invalid or untrusted.

RoleNotFound(String)

The IAM role specified in an STS request does not exist.

BackendError(String)

The upstream object store backend returned an error.

PreconditionFailed

A conditional request header (e.g. If-Match) was not satisfied.

NotModified

The object has not been modified since the time specified by If-Modified-Since.

ConfigError(String)

The proxy configuration is invalid or incomplete.

Internal(String)

An unexpected internal error occurred.

Implementations

impl ProxyError

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

Return the S3-compatible XML error code.

pub fn status_code(&self) -> u16

HTTP status code for this error.

pub fn safe_message(&self) -> String

Return a message safe to show to external clients.

For server-side errors (5xx), returns a generic message to avoid leaking backend infrastructure details. For client errors (4xx), returns the full message (the client already knows the bucket name, key, etc.).

pub fn from_object_store_error(e: Error) -> Self

Convert an object_store::Error into a ProxyError.

Trait Implementations

impl Debug for ProxyError

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

Formats the value using the given formatter.

impl Display for ProxyError

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

Formats the value using the given formatter.

impl Error for ProxyError

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.