Struct S3Error 

pub struct S3Error {
    pub code: S3ErrorCode,
    pub message: String,
    pub resource: Option<String>,
    pub request_id: Option<String>,
    pub status_code: StatusCode,
    pub source: Option<Box<dyn Error + Send + Sync>>,
    pub headers: Option<Box<Vec<(String, String)>>>,
}

An S3 error response.

Fields

code: S3ErrorCode

The error code.

message: String

A human-readable error message.

resource: Option<String>

The resource that caused the error.

request_id: Option<String>

The request ID.

status_code: StatusCode

The HTTP status code.

source: Option<Box<dyn Error + Send + Sync>>

The underlying source error, if any.

headers: Option<Box<Vec<(String, String)>>>

Extra HTTP headers to include in the error response.

Boxed to minimize the size of S3Error on the common (header-free) path.

Implementations

impl S3Error

pub fn new(code: S3ErrorCode) -> Self

Create a new S3Error from an error code.

pub fn with_message(code: S3ErrorCode, message: impl Into<String>) -> Self

Create a new S3Error with a custom message.

pub fn with_resource(self, resource: impl Into<String>) -> Self

Set the resource that caused this error.

pub fn with_request_id(self, request_id: impl Into<String>) -> Self

Set the request ID.

pub fn with_source(self, source: impl Error + Send + Sync + 'static) -> Self

Set the source error.

pub fn with_header( self, name: impl Into<String>, value: impl Into<String>, ) -> Self

Add an extra HTTP header to the error response.

pub fn no_such_bucket(bucket_name: impl Into<String>) -> Self

Create a NoSuchBucket error.

pub fn no_such_key(key: impl Into<String>) -> Self

Create a NoSuchKey error.

pub fn no_such_upload(upload_id: impl Into<String>) -> Self

Create a NoSuchUpload error.

pub fn no_such_version(version_id: impl Into<String>) -> Self

Create a NoSuchVersion error.

pub fn bucket_already_exists(bucket_name: impl Into<String>) -> Self

Create a BucketAlreadyExists error.

pub fn bucket_already_owned_by_you(bucket_name: impl Into<String>) -> Self

Create a BucketAlreadyOwnedByYou error.

pub fn bucket_not_empty(bucket_name: impl Into<String>) -> Self

Create a BucketNotEmpty error.

pub fn access_denied(resource: impl Into<String>) -> Self

Create a AccessDenied error.

pub fn internal_error(message: impl Into<String>) -> Self

Create a InternalError error.

pub fn invalid_argument(message: impl Into<String>) -> Self

Create a InvalidArgument error.

pub fn invalid_bucket_name(bucket_name: impl Into<String>) -> Self

Create a InvalidBucketName error.

pub fn invalid_range(range: impl Into<String>) -> Self

Create a InvalidRange error.

pub fn invalid_part(part_info: impl Into<String>) -> Self

Create a InvalidPart error.

pub fn invalid_part_order(detail: impl Into<String>) -> Self

Create a InvalidPartOrder error.

pub fn malformed_xml(detail: impl Into<String>) -> Self

Create a MalformedXML error.

pub fn method_not_allowed(method: impl Into<String>) -> Self

Create a MethodNotAllowed error.

pub fn not_implemented(detail: impl Into<String>) -> Self

Create a NotImplemented error.

pub fn precondition_failed(condition: impl Into<String>) -> Self

Create a PreconditionFailed error.

pub fn signature_does_not_match(detail: impl Into<String>) -> Self

Create a SignatureDoesNotMatch error.

Trait Implementations

impl Debug for S3Error

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

Formats the value using the given formatter.

impl Display for S3Error

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

Formats the value using the given formatter.

impl Error for S3Error

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.