Skip to main content

ErrorKind

Enum ErrorKind 

Source
#[non_exhaustive]
pub enum ErrorKind { InputInvalid, IOError, RuntimeError, ObjectNotDiscoverable, ServiceError, IntegrityError(IntegrityError), ChildOperationFailed, OperationCancelled, }
Expand description

General categories of transfer errors.

The kind classifies where a failure arose. It does not say whether resubmitting the operation can succeed: failures the transfer manager can repair, such as throttling responses and interrupted body reads, are retried internally before an error of any kind is returned.

Variants (Non-exhaustive)§

This enum is marked as 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.
§

InputInvalid

The operation’s input was rejected: a required field is missing, a value is out of range, settings conflict, or the source cannot be transferred as requested, such as a stream that produces more parts than a multipart upload allows or an object key that resolves outside the download destination or to the destination itself. Conditions visible in the input are reported before any request is sent; conditions that depend on the source data are reported when the transfer encounters them.

§

IOError

An I/O operation failed. This covers both local filesystem failures (opening, reading, writing, or renaming a file) and transport failures while reading an object body from S3, such as a reset connection or a truncated response. The source error identifies which.

Because the kind spans local and remote failures, it does not indicate whether resubmitting the operation can succeed. When a body read fails for a specific chunk, Error::chunk identifies it.

§

RuntimeError

The transfer manager could not continue for an internal reason that is not an input, I/O or service failure.

§

ObjectNotDiscoverable

Object discovery failed for a reason that is not a service-call error, such as a response missing required metadata.

§

ServiceError

A request to S3 failed, or S3 answered with a response the transfer cannot use, such as an UploadPart response without an ETag or a ranged GetObject or HeadObject response whose Content-Range doesn’t match the requested range. The originating operation, service error code (when S3 reported one), message, and request ids are available via the accessors on Error (Error::operation_name, Error::code, Error::request_id).

Service-specific outcomes are identified by their code rather than by a kind of their own. A conditional write whose precondition did not hold (if_match / if_none_match on an upload) arrives here with Error::code of "PreconditionFailed"; S3 reports that code in the response body, so it is available whatever HTTP status carries it.

A whole-object download with checksum validation enabled, or a download of an open-ended or suffix range, discovers the object with HeadObject. S3 answers a failed HeadObject without a body, so the error carries the HTTP status and request ids but no message, and a code only where the status identifies one: "PreconditionFailed" for 412, "NotModified" for 304, "InvalidRange" for 416, and the SDK’s "NotFound" for 404. A missing key is "NotFound", not "NoSuchKey" as a failed GetObject reports.

§

IntegrityError(IntegrityError)

Object integrity validation failed: the received bytes did not match the expected checksum. See the wrapped IntegrityError for detail.

§

ChildOperationFailed

A child of a bulk transfer (upload_objects / download_objects) failed. The individual failures are available via Error::failed_uploads / Error::failed_downloads.

The error’s source is the error of the first failed object. Under FailedTransferPolicy::Abort that is the failure that stopped the transfer.

§

OperationCancelled

The operation was cancelled, either because the user called .abort() on the handle, or a child operation failed under the abort policy.

Trait Implementations§

Source§

impl Clone for ErrorKind

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for ErrorKind

Source§

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

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

impl Eq for ErrorKind

Source§

impl PartialEq for ErrorKind

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for ErrorKind

Auto Trait Implementations§

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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. 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