Skip to main content

Error

Struct Error 

Source
pub struct Error { /* private fields */ }
Expand description

Errors returned by this library.

NOTE: Use aws_smithy_types::error::display::DisplayErrorContext or similar to display the entire error cause/source chain.

Implementations§

Source§

impl Error

Source

pub fn new<E>(kind: ErrorKind, err: E) -> Error
where E: Into<BoxError>,

Creates a new transfer Error from a known kind and an arbitrary source.

Source

pub fn kind(&self) -> &ErrorKind

Returns the corresponding ErrorKind for this error.

Source

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

The S3 operation that produced this error, if it originated from a service call (e.g. "GetObject", "HeadObject", "PutObject").

Source

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

The service error code, if any (e.g. "NoSuchKey", "AccessDenied").

Source

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

The service error message, if any.

Source

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

The AWS request id of the failed call, if any.

Source

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

The AWS extended request id of the failed call, if any.

Source

pub fn is_not_found(&self) -> bool

Whether the service error code denotes a missing bucket, key, or multipart upload.

Source

pub fn chunk(&self) -> Option<&ChunkRef>

The chunk this failure is attributable to, if known.

Source

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

The ID of a multipart upload that the failed upload left open in S3.

Set on the error an upload’s join or abort returns when the upload created a multipart upload that was neither completed nor aborted: the FailedMultipartUploadPolicy::Retain policy kept it, the AbortMultipartUpload request failed, or a worker panicked while executing the upload, as when the caller’s PartStream panics, which ends it with ErrorKind::RuntimeError without sending AbortMultipartUpload. S3 keeps, and bills for, the uploaded parts until the multipart upload is completed or aborted with this ID.

A panic that ends the upload while CompleteMultipartUpload or AbortMultipartUpload is in flight also sets the ID, although that request may still close the multipart upload.

None when no multipart upload was created, when AbortMultipartUpload removed it, and on errors from other operations.

Source

pub fn failed_uploads(&self) -> Option<&[FailedUpload]>

Per-object upload failures, when this error aggregates a bulk upload.

Source

pub fn failed_downloads(&self) -> Option<&[FailedDownload]>

Per-object download failures, when this error aggregates a bulk download.

Trait Implementations§

Source§

impl Debug for Error

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for Error

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Error for Error

Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

The underlying cause.

For ErrorKind::ChildOperationFailed carrying per-object failures, this is the first failed object’s error, so the source chain reaches the child’s own cause. Otherwise it is the error this one was created from.

1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

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. Read more
Source§

impl From<BuildError> for Error

Source§

fn from(value: BuildError) -> Self

Converts to this type from the input type.
Source§

impl From<Error> for Error

Source§

fn from(value: Error) -> Self

Converts to this type from the input type.
Source§

impl From<WalkError> for Error

Source§

fn from(e: WalkError) -> Self

Maps a directory-walk failure to a transfer error, preserving the WalkError as the source so its classification and path remain reachable via std::error::Error::source.

A ListObjectsV2 service failure is recovered to a full ErrorKind::ServiceError (with operation, code, and request ids); an unreadable or non-directory source root is ErrorKind::InputInvalid; per-entry filesystem failures are ErrorKind::IOError.

Auto Trait Implementations§

§

impl !RefUnwindSafe for Error

§

impl !UnwindSafe for Error

§

impl Forget for Error

§

impl Freeze for Error

§

impl Move for Error

§

impl Send for Error

§

impl Sync for Error

§

impl Unpin for Error

§

impl UnsafeUnpin for Error

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

Source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more