Enum Error 

#[non_exhaustive]
pub enum Error {
    ConstructionFailure(ConstructionFailure),
    TimeoutError(TimeoutError),
    DispatchFailure(DispatchFailure),
    Response(ResponseError<Response<SdkBody>>),
    ListBuckets(ListBucketsError),
    CreateBucket(Box<CreateBucketError>),
    GetObject(Box<GetObjectError>),
    ListObjectsV2(ListObjectsV2Error),
    DeleteObject(DeleteObjectError),
    HeadObject(HeadObjectError),
    PutObject(Box<PutObjectError>),
    ByteStream(ByteStreamError),
    HeadBucket(HeadBucketError),
    Library(Cow<'static, str>),
}

Represents a generalised error that inlines all service errors and uses Response<SdkBody> as the response type.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ConstructionFailure(ConstructionFailure)

Request failed during construction, it was not dispatched over the network.

TimeoutError(TimeoutError)

Request failed due to a timeout, the request MAY have been sent and received.

DispatchFailure(DispatchFailure)

Request failed during dispatch, an HTTP response was not received. The request MAY have been set.

Response(ResponseError<Response<SdkBody>>)

A response was received but it was not parseable according to the protocol. (for example, the server hung up without sending a complete response)

ListBuckets(ListBucketsError)

Amazon S3 was unable to list buckets. This happens when you call StorageService::init, since the library performs checks whenever if the bucket exists or not and it needs the ability to check.

CreateBucket(Box<CreateBucketError>)

Amazon S3 was unable to create the bucket for some reason, this will never hit the CreateBucketError::BucketAlreadyExists or CreateBucketError::BucketAlreadyOwnedByYou variants, something might’ve been unhandled and is probably isn’t your fault.

• this would be thrown from the StorageService::init trait method

GetObject(Box<GetObjectError>)

Amazon S3 was unable to get the object that you were looking for either from the StorageService::open or the StorageService::blob methods.

The GetObjectError::NoSuchKey variant will never be reached since it’ll return Ok(None) if the key wasn’t present in S3, this might result in an invalid object state (GetObjectError::InvalidObjectState) or an unhandled variant that the Rust SDK doesn’t support yet.

• this would be thrown from the StorageService::open or the StorageService::blob trait methods.

ListObjectsV2(ListObjectsV2Error)

Amazon S3 was unable to list objects from the specific requirements that it was told to list objects from a ListBlobsRequest.

This might be in a unhandled state as ListObjectsV2Error::NoSuchBucket should never be matched since remi-s3 handles creating buckets if they don’t exist when StorageService::init is called.

• this would be thrown from the StorageService::open or the StorageService::blob trait methods.

DeleteObject(DeleteObjectError)

Amazon S3 was unable to delete an object from the service.

• this would be thrown from the StorageService::delete trait method.

HeadObject(HeadObjectError)

Amazon S3 was unable to check the existence of an object. This will never reach the HeadObjectError::NotFound state as it’ll return Ok(false).

• this would be thrown from the StorageService::exists trait method.

PutObject(Box<PutObjectError>)

Amazon S3 was unable to put an object into the service.

• this would be thrown from the StorageService::upload trait method.

ByteStream(ByteStreamError)

Occurs when an error occurred when transforming AWS S3’s responses.

HeadBucket(HeadBucketError)

Occurs when remi-s3 cannot perform a HEAD request to the current bucket. This is mainly used in healthchecks to determine if the storage service is ok.

Library(Cow<'static, str>)

Something that remi-s3 has emitted on its own.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

fn from(value: ByteStreamError) -> Self

Converts to this type from the input type.

impl From<GetObjectError> for Error

fn from(value: GetObjectError) -> Self

Converts to this type from the input type.

impl From<HeadObjectError> for Error

fn from(value: HeadObjectError) -> Self

Converts to this type from the input type.

impl From<SdkError<CreateBucketError, Response>> for Error

fn from(error: SdkError<CreateBucketError, Response<SdkBody>>) -> Self

Converts to this type from the input type.

impl From<SdkError<DeleteObjectError, Response>> for Error

fn from(error: SdkError<DeleteObjectError, Response<SdkBody>>) -> Self

Converts to this type from the input type.

impl From<SdkError<GetObjectError, Response>> for Error

fn from(error: SdkError<GetObjectError, Response<SdkBody>>) -> Self

Converts to this type from the input type.

impl From<SdkError<HeadBucketError, Response>> for Error

fn from(value: SdkError<HeadBucketError, Response<SdkBody>>) -> Self

Converts to this type from the input type.

impl From<SdkError<HeadObjectError, Response>> for Error

fn from(error: SdkError<HeadObjectError, Response<SdkBody>>) -> Self

Converts to this type from the input type.

impl From<SdkError<ListBucketsError, Response>> for Error

fn from(error: SdkError<ListBucketsError, Response<SdkBody>>) -> Self

Converts to this type from the input type.

impl From<SdkError<ListObjectsV2Error, Response>> for Error

fn from(error: SdkError<ListObjectsV2Error, Response<SdkBody>>) -> Self

Converts to this type from the input type.

impl From<SdkError<PutObjectError, Response>> for Error

fn from(error: SdkError<PutObjectError, Response<SdkBody>>) -> Self

Converts to this type from the input type.