Enum aws_sdk_lambda::error::SdkError

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

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)

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 without sending a complete response)

ServiceError(ServiceError<E, R>)

An error response was received from the service

Implementations

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

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

Construct a SdkError for a construction failure

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

Construct a SdkError for a timeout

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

Construct a SdkError for a dispatch failure with a ConnectorError

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

Construct a SdkError for a response error

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

Construct a SdkError for a service failure

pub fn into_service_error(self) -> E

where 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::NoSuchKey(_) => {
        // handle NoSuchKey
    }
    err @ _ => return Err(err),
}

pub fn into_source(self) -> Result<Box<dyn Error + Sync + Send>, 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.

pub fn raw_response(&self) -> Option<&R>

Return a reference to this error’s raw response, if it contains one. Otherwise, return None.

Trait Implementations

impl<T, E> ClassifyRetry<T, SdkError<E>> for AwsResponseRetryClassifier

where E: ProvideErrorKind,

fn classify_retry(&self, result: Result<&T, &SdkError<E>>) -> RetryKind

Run this classifier against a response to determine if it should be retried.

impl<T, E> ClassifyRetry<T, SdkError<E>> for DefaultResponseRetryClassifier

where E: ProvideErrorKind,

fn classify_retry(&self, result: Result<&T, &SdkError<E>>) -> RetryKind

Run this classifier against a response to determine if it should be retried.

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

where E: Debug, R: Debug,

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

Formats the value using the given formatter.

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

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

Formats the value using the given formatter.

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

where E: Error + 'static, R: Debug,

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

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<R> From<SdkError<AddLayerVersionPermissionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<AddPermissionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<CreateAliasError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<CreateCodeSigningConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<CreateEventSourceMappingError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<CreateFunctionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<CreateFunctionUrlConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<DeleteAliasError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<DeleteCodeSigningConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<DeleteEventSourceMappingError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<DeleteFunctionCodeSigningConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<DeleteFunctionConcurrencyError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<DeleteFunctionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<DeleteFunctionEventInvokeConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<DeleteFunctionUrlConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<DeleteLayerVersionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<DeleteProvisionedConcurrencyConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetAccountSettingsError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetAliasError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetCodeSigningConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetEventSourceMappingError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetFunctionCodeSigningConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetFunctionConcurrencyError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetFunctionConfigurationError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetFunctionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetFunctionEventInvokeConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetFunctionUrlConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetLayerVersionByArnError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetLayerVersionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetLayerVersionPolicyError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetPolicyError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetProvisionedConcurrencyConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<GetRuntimeManagementConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<InvokeAsyncError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<InvokeError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListAliasesError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListCodeSigningConfigsError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListEventSourceMappingsError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListFunctionEventInvokeConfigsError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListFunctionUrlConfigsError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListFunctionsByCodeSigningConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListFunctionsError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListLayerVersionsError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListLayersError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListProvisionedConcurrencyConfigsError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListTagsError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<ListVersionsByFunctionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<PublishLayerVersionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<PublishVersionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<PutFunctionCodeSigningConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<PutFunctionConcurrencyError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<PutFunctionEventInvokeConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<PutProvisionedConcurrencyConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<PutRuntimeManagementConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<RemoveLayerVersionPermissionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<RemovePermissionError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<TagResourceError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<UntagResourceError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<UpdateAliasError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<UpdateCodeSigningConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<UpdateEventSourceMappingError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<UpdateFunctionCodeError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<UpdateFunctionConfigurationError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<UpdateFunctionEventInvokeConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

impl<R> From<SdkError<UpdateFunctionUrlConfigError, R>> for Error

where R: Send + Sync + Debug + 'static,

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

Converts to this type from the input type.

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

Convert a SendOperationError into an SdkError

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

Converts to this type from the input type.

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

where E: ProvideErrorMetadata,

fn meta(&self) -> &ErrorMetadata

Returns error metadata, which includes the error code, message, request ID, and potentially additional information.

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

Returns the error code if it’s available.

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

Returns the error message, if there is one.

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

where R: HttpHeaders,

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

Returns the request ID, or None if the service could not be reached.