Enum aws_sdk_sqs::Error

#[non_exhaustive]
pub enum Error {
    BatchEntryIdsNotDistinct(BatchEntryIdsNotDistinct),
    BatchRequestTooLong(BatchRequestTooLong),
    EmptyBatchRequest(EmptyBatchRequest),
    InvalidAddress(InvalidAddress),
    InvalidAttributeName(InvalidAttributeName),
    InvalidAttributeValue(InvalidAttributeValue),
    InvalidBatchEntryId(InvalidBatchEntryId),
    InvalidIdFormat(InvalidIdFormat),
    InvalidMessageContents(InvalidMessageContents),
    InvalidSecurity(InvalidSecurity),
    KmsAccessDenied(KmsAccessDenied),
    KmsDisabled(KmsDisabled),
    KmsInvalidKeyUsage(KmsInvalidKeyUsage),
    KmsInvalidState(KmsInvalidState),
    KmsNotFound(KmsNotFound),
    KmsOptInRequired(KmsOptInRequired),
    KmsThrottled(KmsThrottled),
    MessageNotInflight(MessageNotInflight),
    OverLimit(OverLimit),
    PurgeQueueInProgress(PurgeQueueInProgress),
    QueueDeletedRecently(QueueDeletedRecently),
    QueueDoesNotExist(QueueDoesNotExist),
    QueueNameExists(QueueNameExists),
    ReceiptHandleIsInvalid(ReceiptHandleIsInvalid),
    RequestThrottled(RequestThrottled),
    ResourceNotFoundException(ResourceNotFoundException),
    TooManyEntriesInBatchRequest(TooManyEntriesInBatchRequest),
    UnsupportedOperation(UnsupportedOperation),
    Unhandled(Unhandled),
}

All possible error types for this service.

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.

BatchEntryIdsNotDistinct(BatchEntryIdsNotDistinct)

Two or more batch entries in the request have the same Id.

BatchRequestTooLong(BatchRequestTooLong)

The length of all the messages put together is more than the limit.

EmptyBatchRequest(EmptyBatchRequest)

The batch request doesn't contain any entries.

InvalidAddress(InvalidAddress)

The accountId is invalid.

InvalidAttributeName(InvalidAttributeName)

The specified attribute doesn't exist.

InvalidAttributeValue(InvalidAttributeValue)

A queue attribute value is invalid.

InvalidBatchEntryId(InvalidBatchEntryId)

The Id of a batch entry in a batch request doesn't abide by the specification.

InvalidIdFormat(InvalidIdFormat)

👎Deprecated: exception has been included in ReceiptHandleIsInvalid

The specified receipt handle isn't valid for the current version.

InvalidMessageContents(InvalidMessageContents)

The message contains characters outside the allowed set.

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.

MessageNotInflight(MessageNotInflight)

The specified message isn't in flight.

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.

PurgeQueueInProgress(PurgeQueueInProgress)

Indicates that the specified queue previously received a PurgeQueue request within the last 60 seconds (the time it can take to delete the messages in the queue).

QueueDeletedRecently(QueueDeletedRecently)

You must wait 60 seconds after deleting a queue before you can create another queue with the same name.

QueueDoesNotExist(QueueDoesNotExist)

The specified queue doesn't exist.

QueueNameExists(QueueNameExists)

A queue with this name already exists. Amazon SQS returns this error only if the request includes attributes whose values differ from those of the existing queue.

ReceiptHandleIsInvalid(ReceiptHandleIsInvalid)

The specified receipt handle isn't valid.

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.

ResourceNotFoundException(ResourceNotFoundException)

One or more specified resources don't exist.

TooManyEntriesInBatchRequest(TooManyEntriesInBatchRequest)

The batch request contains more entries than permissible.

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

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<AddPermissionError> for Error

fn from(err: AddPermissionError) -> Self

Converts to this type from the input type.

impl From<BuildError> for Error

fn from(value: BuildError) -> Self

Converts to this type from the input type.

impl From<CancelMessageMoveTaskError> for Error

fn from(err: CancelMessageMoveTaskError) -> Self

Converts to this type from the input type.

impl From<ChangeMessageVisibilityBatchError> for Error

fn from(err: ChangeMessageVisibilityBatchError) -> Self

Converts to this type from the input type.

impl From<ChangeMessageVisibilityError> for Error

fn from(err: ChangeMessageVisibilityError) -> Self

Converts to this type from the input type.

impl From<CreateQueueError> for Error

fn from(err: CreateQueueError) -> Self

Converts to this type from the input type.

impl From<DeleteMessageBatchError> for Error

fn from(err: DeleteMessageBatchError) -> Self

Converts to this type from the input type.

impl From<DeleteMessageError> for Error

fn from(err: DeleteMessageError) -> Self

Converts to this type from the input type.

impl From<DeleteQueueError> for Error

fn from(err: DeleteQueueError) -> Self

Converts to this type from the input type.

impl From<GetQueueAttributesError> for Error

fn from(err: GetQueueAttributesError) -> Self

Converts to this type from the input type.

impl From<GetQueueUrlError> for Error

fn from(err: GetQueueUrlError) -> Self

Converts to this type from the input type.

impl From<ListDeadLetterSourceQueuesError> for Error

fn from(err: ListDeadLetterSourceQueuesError) -> Self

Converts to this type from the input type.

impl From<ListMessageMoveTasksError> for Error

fn from(err: ListMessageMoveTasksError) -> Self

Converts to this type from the input type.

impl From<ListQueueTagsError> for Error

fn from(err: ListQueueTagsError) -> Self

Converts to this type from the input type.

impl From<ListQueuesError> for Error

fn from(err: ListQueuesError) -> Self

Converts to this type from the input type.

impl From<PurgeQueueError> for Error

fn from(err: PurgeQueueError) -> Self

Converts to this type from the input type.

impl From<ReceiveMessageError> for Error

fn from(err: ReceiveMessageError) -> Self

Converts to this type from the input type.

impl From<RemovePermissionError> for Error

fn from(err: RemovePermissionError) -> 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<CancelMessageMoveTaskError, R>> for Error

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

fn from(err: SdkError<ReceiveMessageError, 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<SendMessageBatchError, R>> for Error

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

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

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

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

Converts to this type from the input type.

impl From<SendMessageBatchError> for Error

fn from(err: SendMessageBatchError) -> Self

Converts to this type from the input type.

impl From<SendMessageError> for Error

fn from(err: SendMessageError) -> Self

Converts to this type from the input type.

impl From<SetQueueAttributesError> for Error

fn from(err: SetQueueAttributesError) -> Self

Converts to this type from the input type.

impl From<StartMessageMoveTaskError> for Error

fn from(err: StartMessageMoveTaskError) -> Self

Converts to this type from the input type.

impl From<TagQueueError> for Error

fn from(err: TagQueueError) -> Self

Converts to this type from the input type.

impl From<UntagQueueError> for Error

fn from(err: UntagQueueError) -> Self

Converts to this type from the input type.

impl ProvideErrorMetadata for Error

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 Error

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

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