Enum aws_sdk_sqs::operation::receive_message::ReceiveMessageError

#[non_exhaustive]
pub enum ReceiveMessageError {
    InvalidAddress(InvalidAddress),
    InvalidSecurity(InvalidSecurity),
    KmsAccessDenied(KmsAccessDenied),
    KmsDisabled(KmsDisabled),
    KmsInvalidKeyUsage(KmsInvalidKeyUsage),
    KmsInvalidState(KmsInvalidState),
    KmsNotFound(KmsNotFound),
    KmsOptInRequired(KmsOptInRequired),
    KmsThrottled(KmsThrottled),
    OverLimit(OverLimit),
    QueueDoesNotExist(QueueDoesNotExist),
    RequestThrottled(RequestThrottled),
    UnsupportedOperation(UnsupportedOperation),
    Unhandled(Unhandled),
}

Error type for the ReceiveMessageError operation.

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.

InvalidAddress(InvalidAddress)

The accountId is invalid.

InvalidSecurity(InvalidSecurity)

When the request to a queue is not HTTPS and SigV4.

KmsAccessDenied(KmsAccessDenied)

The caller doesn't have the required KMS access.

KmsDisabled(KmsDisabled)

The request was denied due to request throttling.

KmsInvalidKeyUsage(KmsInvalidKeyUsage)

The request was rejected for one of the following reasons:

• The KeyUsage value of the KMS key is incompatible with the API operation.

• The encryption algorithm or signing algorithm specified for the operation is incompatible with the type of key material in the KMS key (KeySpec).

KmsInvalidState(KmsInvalidState)

The request was rejected because the state of the specified resource is not valid for this request.

KmsNotFound(KmsNotFound)

The request was rejected because the specified entity or resource could not be found.

KmsOptInRequired(KmsOptInRequired)

The request was rejected because the specified key policy isn't syntactically or semantically correct.

KmsThrottled(KmsThrottled)

Amazon Web Services KMS throttles requests for the following conditions.

OverLimit(OverLimit)

The specified action violates a limit. For example, ReceiveMessage returns this error if the maximum number of in flight messages is reached and AddPermission returns this error if the maximum number of permissions for the queue is reached.

QueueDoesNotExist(QueueDoesNotExist)

The specified queue doesn't exist.

RequestThrottled(RequestThrottled)

The request was denied due to request throttling.

• The rate of requests per second exceeds the Amazon Web Services KMS request quota for an account and Region.

• A burst or sustained high rate of requests to change the state of the same KMS key. This condition is often known as a "hot key."

• Requests for operations on KMS keys in a Amazon Web Services CloudHSM key store might be throttled at a lower-than-expected rate when the Amazon Web Services CloudHSM cluster associated with the Amazon Web Services CloudHSM key store is processing numerous commands, including those unrelated to the Amazon Web Services CloudHSM key store.

UnsupportedOperation(UnsupportedOperation)

Error code 400. Unsupported operation.

Unhandled(Unhandled)

👎Deprecated: Matching Unhandled directly is not forwards compatible. Instead, match using a variable wildcard pattern and check .code():    err if err.code() == Some("SpecificExceptionCode") => { /* handle the error */ } See ProvideErrorMetadata for what information is available for the error.

An unexpected error occurred (e.g., invalid JSON returned by the service or an unknown error code).

Implementations

impl ReceiveMessageError

pub fn unhandled(err: impl Into<Box<dyn Error + Send + Sync + 'static>>) -> Self

Creates the ReceiveMessageError::Unhandled variant from any error type.

pub fn generic(err: ErrorMetadata) -> Self

Creates the ReceiveMessageError::Unhandled variant from an ErrorMetadata.

pub fn meta(&self) -> &ErrorMetadata

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

pub fn is_invalid_address(&self) -> bool

Returns true if the error kind is ReceiveMessageError::InvalidAddress.

pub fn is_invalid_security(&self) -> bool

Returns true if the error kind is ReceiveMessageError::InvalidSecurity.

pub fn is_kms_access_denied(&self) -> bool

Returns true if the error kind is ReceiveMessageError::KmsAccessDenied.

pub fn is_kms_disabled(&self) -> bool

Returns true if the error kind is ReceiveMessageError::KmsDisabled.

pub fn is_kms_invalid_key_usage(&self) -> bool

Returns true if the error kind is ReceiveMessageError::KmsInvalidKeyUsage.

pub fn is_kms_invalid_state(&self) -> bool

Returns true if the error kind is ReceiveMessageError::KmsInvalidState.

pub fn is_kms_not_found(&self) -> bool

Returns true if the error kind is ReceiveMessageError::KmsNotFound.

pub fn is_kms_opt_in_required(&self) -> bool

Returns true if the error kind is ReceiveMessageError::KmsOptInRequired.

pub fn is_kms_throttled(&self) -> bool

Returns true if the error kind is ReceiveMessageError::KmsThrottled.

pub fn is_over_limit(&self) -> bool

Returns true if the error kind is ReceiveMessageError::OverLimit.

pub fn is_queue_does_not_exist(&self) -> bool

Returns true if the error kind is ReceiveMessageError::QueueDoesNotExist.

pub fn is_request_throttled(&self) -> bool

Returns true if the error kind is ReceiveMessageError::RequestThrottled.

pub fn is_unsupported_operation(&self) -> bool

Returns true if the error kind is ReceiveMessageError::UnsupportedOperation.

Trait Implementations

impl CreateUnhandledError for ReceiveMessageError

fn create_unhandled_error( source: Box<dyn Error + Send + Sync + 'static>, meta: Option<ErrorMetadata> ) -> Self

Creates an unhandled error variant with the given source and error metadata.

impl Debug for ReceiveMessageError

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

Formats the value using the given formatter.

impl Display for ReceiveMessageError

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

Formats the value using the given formatter.

impl Error for ReceiveMessageError

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

fn from(err: ReceiveMessageError) -> Self

Converts to this type from the input type.

impl ProvideErrorKind for ReceiveMessageError

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

Returns the code for this error if one exists

fn retryable_error_kind(&self) -> Option<ErrorKind>

Returns the ErrorKind when the error is modeled as retryable

impl ProvideErrorMetadata for ReceiveMessageError

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 RequestId for ReceiveMessageError

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

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