#[non_exhaustive]
pub enum SdkError<E, R = Response> {
    ConstructionFailure(ConstructionFailure),
    TimeoutError(TimeoutError),
    DispatchFailure(DispatchFailure),
    ResponseError(ResponseError<R>),
    ServiceError(ServiceError<E, R>),
}
Expand description

Failed SDK Result

When logging an error from the SDK, it is recommended that you either wrap the error in DisplayErrorContext, use another error reporter library that visits the error’s cause/source chain, or call Error::source for more details about the underlying cause.

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.
§

ConstructionFailure(ConstructionFailure)

The request failed during construction. It was not dispatched over the network.

§

TimeoutError(TimeoutError)

The request failed due to a timeout. The request MAY have been sent and received.

§

DispatchFailure(DispatchFailure)

The request failed during dispatch. An HTTP response was not received. The request MAY have been sent.

§

ResponseError(ResponseError<R>)

A response was received but it was not parseable according the the protocol (for example the server hung up while the body was being read)

§

ServiceError(ServiceError<E, R>)

An error response was received from the service

Implementations§

source§

impl<E, R> SdkError<E, R>

source

pub fn construction_failure( source: impl Into<Box<dyn Error + Send + Sync + 'static, Global>> ) -> SdkError<E, R>

Construct a SdkError for a construction failure

source

pub fn timeout_error( source: impl Into<Box<dyn Error + Send + Sync + 'static, Global>> ) -> SdkError<E, R>

Construct a SdkError for a timeout

source

pub fn dispatch_failure(source: ConnectorError) -> SdkError<E, R>

Construct a SdkError for a dispatch failure with a ConnectorError

source

pub fn response_error( source: impl Into<Box<dyn Error + Send + Sync + 'static, Global>>, raw: R ) -> SdkError<E, R>

Construct a SdkError for a response error

source

pub fn service_error(source: E, raw: R) -> SdkError<E, R>

Construct a SdkError for a service failure

source

pub fn into_service_error(self) -> Ewhere E: Error + Send + Sync + CreateUnhandledError + 'static, R: Debug + Send + Sync + 'static,

Returns the underlying service error E if there is one

If the SdkError is not a ServiceError (for example, the error is a network timeout), then it will be converted into an unhandled variant of E. This makes it easy to match on the service’s error response while simultaneously bubbling up transient failures. For example, handling the NoSuchKey error for S3’s GetObject operation may look as follows:

match sdk_err.into_service_error() {
    GetObjectError { kind: GetObjectErrorKind::NoSuchKey(_) } => {
        // handle NoSuchKey
    }
    err @ _ => return Err(err),
}
source

pub fn into_source( self ) -> Result<Box<dyn Error + Send + Sync + 'static, Global>, SdkError<E, R>>where E: Error + Send + Sync + 'static,

Converts this error into its error source.

If there is no error source, then Err(Self) is returned.

Trait Implementations§

source§

impl<T, E> ClassifyRetry<T, SdkError<E, Response>> for AwsResponseRetryClassifierwhere E: ProvideErrorKind,

source§

impl<T, E> ClassifyRetry<T, SdkError<E, Response>> for DefaultResponseRetryClassifierwhere E: ProvideErrorKind,

source§

impl<E, R> Debug for SdkError<E, R>where E: Debug, R: Debug,

source§

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

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

impl<E, R> Display for SdkError<E, R>

source§

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

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

impl<E, R> Error for SdkError<E, R>where E: Error + 'static, R: Debug,

source§

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

The lower-level source of this error, if any. Read more
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, demand: &mut Demand<'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<R> From<SdkError<BatchGetNamedQueryError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<BatchGetNamedQueryError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<BatchGetPreparedStatementError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<BatchGetPreparedStatementError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<BatchGetQueryExecutionError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<BatchGetQueryExecutionError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<CreateDataCatalogError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<CreateDataCatalogError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<CreateNamedQueryError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<CreateNamedQueryError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<CreateNotebookError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<CreateNotebookError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<CreatePreparedStatementError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<CreatePreparedStatementError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<CreatePresignedNotebookUrlError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<CreatePresignedNotebookUrlError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<CreateWorkGroupError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<CreateWorkGroupError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<DeleteDataCatalogError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<DeleteDataCatalogError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<DeleteNamedQueryError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<DeleteNamedQueryError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<DeleteNotebookError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<DeleteNotebookError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<DeletePreparedStatementError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<DeletePreparedStatementError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<DeleteWorkGroupError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<DeleteWorkGroupError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ExportNotebookError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ExportNotebookError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetCalculationExecutionCodeError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetCalculationExecutionCodeError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetCalculationExecutionError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetCalculationExecutionError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetCalculationExecutionStatusError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetCalculationExecutionStatusError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetDataCatalogError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetDataCatalogError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetDatabaseError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetDatabaseError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetNamedQueryError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetNamedQueryError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetNotebookMetadataError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetNotebookMetadataError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetPreparedStatementError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetPreparedStatementError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetQueryExecutionError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetQueryExecutionError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetQueryResultsError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetQueryResultsError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetQueryRuntimeStatisticsError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetQueryRuntimeStatisticsError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetSessionError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetSessionError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetSessionStatusError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetSessionStatusError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetTableMetadataError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetTableMetadataError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<GetWorkGroupError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<GetWorkGroupError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ImportNotebookError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ImportNotebookError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListApplicationDPUSizesError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListApplicationDPUSizesError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListCalculationExecutionsError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListCalculationExecutionsError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListDataCatalogsError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListDataCatalogsError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListDatabasesError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListDatabasesError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListEngineVersionsError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListEngineVersionsError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListExecutorsError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListExecutorsError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListNamedQueriesError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListNamedQueriesError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListNotebookMetadataError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListNotebookMetadataError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListNotebookSessionsError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListNotebookSessionsError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListPreparedStatementsError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListPreparedStatementsError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListQueryExecutionsError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListQueryExecutionsError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListSessionsError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListSessionsError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListTableMetadataError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListTableMetadataError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListTagsForResourceError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListTagsForResourceError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<ListWorkGroupsError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<ListWorkGroupsError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<StartCalculationExecutionError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<StartCalculationExecutionError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<StartQueryExecutionError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<StartQueryExecutionError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<StartSessionError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<StartSessionError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<StopCalculationExecutionError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<StopCalculationExecutionError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<StopQueryExecutionError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<StopQueryExecutionError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<TagResourceError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<TagResourceError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<TerminateSessionError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<TerminateSessionError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<UntagResourceError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<UntagResourceError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<UpdateDataCatalogError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<UpdateDataCatalogError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<UpdateNamedQueryError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<UpdateNamedQueryError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<UpdateNotebookError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<UpdateNotebookError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<UpdateNotebookMetadataError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<UpdateNotebookMetadataError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<UpdatePreparedStatementError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<UpdatePreparedStatementError, R>) -> Self

Converts to this type from the input type.
source§

impl<R> From<SdkError<UpdateWorkGroupError, R>> for Errorwhere R: Send + Sync + Debug + 'static,

source§

fn from(err: SdkError<UpdateWorkGroupError, R>) -> Self

Converts to this type from the input type.
source§

impl<E> From<SendOperationError> for SdkError<E, Response>

Convert a SendOperationError into an SdkError

source§

fn from(err: SendOperationError) -> SdkError<E, Response>

Converts to this type from the input type.

Auto Trait Implementations§

§

impl<E, R = Response> !RefUnwindSafe for SdkError<E, R>

§

impl<E, R> Send for SdkError<E, R>where E: Send, R: Send,

§

impl<E, R> Sync for SdkError<E, R>where E: Sync, R: Sync,

§

impl<E, R> Unpin for SdkError<E, R>where E: Unpin, R: Unpin,

§

impl<E, R = Response> !UnwindSafe for SdkError<E, R>

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

const: unstable · source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

const: unstable · source§

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

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

const: unstable · 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 Twhere U: From<T>,

const: unstable · 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<E> Provider for Ewhere E: Error + ?Sized,

source§

fn provide<'a>(&'a self, demand: &mut Demand<'a>)

🔬This is a nightly-only experimental API. (provide_any)
Data providers should implement this method to provide all values they are able to provide by using demand. Read more
source§

impl<T> Same<T> for T

§

type Output = T

Should always be Self
source§

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

source§

default fn to_string(&self) -> String

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

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

§

type Error = Infallible

The type returned in the event of a conversion error.
const: unstable · source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

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

§

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

The type returned in the event of a conversion error.
const: unstable · source§

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

Performs the conversion.
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