Enum aws_sdk_dynamodb::operation::put_item::PutItemError

#[non_exhaustive]
pub enum PutItemError {
    ConditionalCheckFailedException(ConditionalCheckFailedException),
    InternalServerError(InternalServerError),
    InvalidEndpointException(InvalidEndpointException),
    ItemCollectionSizeLimitExceededException(ItemCollectionSizeLimitExceededException),
    ProvisionedThroughputExceededException(ProvisionedThroughputExceededException),
    ReplicatedWriteConflictException(ReplicatedWriteConflictException),
    RequestLimitExceeded(RequestLimitExceeded),
    ResourceNotFoundException(ResourceNotFoundException),
    TransactionConflictException(TransactionConflictException),
    Unhandled(Unhandled),
}

Error type for the PutItemError 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.

ConditionalCheckFailedException(ConditionalCheckFailedException)

A condition specified in the operation could not be evaluated.

InternalServerError(InternalServerError)

An error occurred on the server side.

InvalidEndpointException(InvalidEndpointException)

ItemCollectionSizeLimitExceededException(ItemCollectionSizeLimitExceededException)

An item collection is too large. This exception is only returned for tables that have one or more local secondary indexes.

ProvisionedThroughputExceededException(ProvisionedThroughputExceededException)

Your request rate is too high. The Amazon Web Services SDKs for DynamoDB automatically retry requests that receive this exception. Your request is eventually successful, unless your retry queue is too large to finish. Reduce the frequency of requests and use exponential backoff. For more information, go to Error Retries and Exponential Backoff in the Amazon DynamoDB Developer Guide.

ReplicatedWriteConflictException(ReplicatedWriteConflictException)

The request was rejected because one or more items in the request are being modified by a request in another Region.

RequestLimitExceeded(RequestLimitExceeded)

Throughput exceeds the current throughput quota for your account. Please contact Amazon Web Services Support to request a quota increase.

ResourceNotFoundException(ResourceNotFoundException)

The operation tried to access a nonexistent table or index. The resource might not be specified correctly, or its status might not be ACTIVE.

TransactionConflictException(TransactionConflictException)

Operation was rejected because there is an ongoing transaction for the item.

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 PutItemError

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

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

pub fn generic(err: ErrorMetadata) -> Self

Creates the PutItemError::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_conditional_check_failed_exception(&self) -> bool

Returns true if the error kind is PutItemError::ConditionalCheckFailedException.

pub fn is_internal_server_error(&self) -> bool

Returns true if the error kind is PutItemError::InternalServerError.

pub fn is_invalid_endpoint_exception(&self) -> bool

Returns true if the error kind is PutItemError::InvalidEndpointException.

pub fn is_item_collection_size_limit_exceeded_exception(&self) -> bool

Returns true if the error kind is PutItemError::ItemCollectionSizeLimitExceededException.

pub fn is_provisioned_throughput_exceeded_exception(&self) -> bool

Returns true if the error kind is PutItemError::ProvisionedThroughputExceededException.

pub fn is_replicated_write_conflict_exception(&self) -> bool

Returns true if the error kind is PutItemError::ReplicatedWriteConflictException.

pub fn is_request_limit_exceeded(&self) -> bool

Returns true if the error kind is PutItemError::RequestLimitExceeded.

pub fn is_resource_not_found_exception(&self) -> bool

Returns true if the error kind is PutItemError::ResourceNotFoundException.

pub fn is_transaction_conflict_exception(&self) -> bool

Returns true if the error kind is PutItemError::TransactionConflictException.

Trait Implementations

impl CreateUnhandledError for PutItemError

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 PutItemError

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

Formats the value using the given formatter.

impl Display for PutItemError

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

Formats the value using the given formatter.

impl Error for PutItemError

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

fn from(err: PutItemError) -> Self

Converts to this type from the input type.

impl ProvideErrorKind for PutItemError

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 PutItemError

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 PutItemError

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

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