Enum PutObjectError

#[non_exhaustive]
pub enum PutObjectError {
    AccessDeniedException(AccessDeniedException),
    IllegalArgumentException(IllegalArgumentException),
    KmsInvalidKeyUsageException(KmsInvalidKeyUsageException),
    NotReadableInputStreamException(NotReadableInputStreamException),
    RetryableException(RetryableException),
    ServiceInternalException(ServiceInternalException),
    ServiceUnavailableException(ServiceUnavailableException),
    ThrottlingException(ThrottlingException),
    Unhandled(Unhandled),
}

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

AccessDeniedException(AccessDeniedException)

IllegalArgumentException(IllegalArgumentException)

Non-retryable exception, indicates client error (wrong argument passed to API). See exception message for details.

KmsInvalidKeyUsageException(KmsInvalidKeyUsageException)

Non-retryable exception. Indicates the KMS key usage is incorrect. See exception message for details.

NotReadableInputStreamException(NotReadableInputStreamException)

Retryalble exception. Indicated issues while reading an input stream due to the networking issues or connection drop on the client side.

RetryableException(RetryableException)

Retryable exception. In general indicates internal failure that can be fixed by retry.

ServiceInternalException(ServiceInternalException)

Deprecated. To be removed from the model.

ServiceUnavailableException(ServiceUnavailableException)

Retryable exception, indicates internal server error.

ThrottlingException(ThrottlingException)

Increased rate over throttling limits. Can be retried with exponential backoff.

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 PutObjectError

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

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

pub fn generic(err: ErrorMetadata) -> Self

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

Returns true if the error kind is PutObjectError::AccessDeniedException.

pub fn is_illegal_argument_exception(&self) -> bool

Returns true if the error kind is PutObjectError::IllegalArgumentException.

pub fn is_kms_invalid_key_usage_exception(&self) -> bool

Returns true if the error kind is PutObjectError::KmsInvalidKeyUsageException.

pub fn is_not_readable_input_stream_exception(&self) -> bool

Returns true if the error kind is PutObjectError::NotReadableInputStreamException.

pub fn is_retryable_exception(&self) -> bool

Returns true if the error kind is PutObjectError::RetryableException.

pub fn is_service_internal_exception(&self) -> bool

Returns true if the error kind is PutObjectError::ServiceInternalException.

pub fn is_service_unavailable_exception(&self) -> bool

Returns true if the error kind is PutObjectError::ServiceUnavailableException.

pub fn is_throttling_exception(&self) -> bool

Returns true if the error kind is PutObjectError::ThrottlingException.

Trait Implementations

impl CreateUnhandledError for PutObjectError

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 PutObjectError

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

Formats the value using the given formatter.

impl Display for PutObjectError

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

Formats the value using the given formatter.

impl Error for PutObjectError

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

Returns 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<PutObjectError> for Error

fn from(err: PutObjectError) -> Self

Converts to this type from the input type.

impl ProvideErrorKind for PutObjectError

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 PutObjectError

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 PutObjectError

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

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