Enum aws_sdk_s3::operation::get_object::GetObjectError
source · #[non_exhaustive]pub enum GetObjectError {
InvalidObjectState(InvalidObjectState),
NoSuchKey(NoSuchKey),
Unhandled(Unhandled),
}
Expand description
Error type for the GetObjectError
operation.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
InvalidObjectState(InvalidObjectState)
Object is archived and inaccessible until restored.
If the object you are retrieving is stored in the S3 Glacier Flexible Retrieval storage class, the S3 Glacier Deep Archive storage class, the S3 Intelligent-Tiering Archive Access tier, or the S3 Intelligent-Tiering Deep Archive Access tier, before you can retrieve the object you must first restore a copy using RestoreObject. Otherwise, this operation returns an InvalidObjectState
error. For information about restoring archived objects, see Restoring Archived Objects in the Amazon S3 User Guide.
NoSuchKey(NoSuchKey)
The specified key does not exist.
Unhandled(Unhandled)
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§
source§impl GetObjectError
impl GetObjectError
sourcepub fn unhandled(err: impl Into<Box<dyn Error + Send + Sync + 'static>>) -> Self
pub fn unhandled(err: impl Into<Box<dyn Error + Send + Sync + 'static>>) -> Self
Creates the GetObjectError::Unhandled
variant from any error type.
sourcepub fn generic(err: ErrorMetadata) -> Self
pub fn generic(err: ErrorMetadata) -> Self
Creates the GetObjectError::Unhandled
variant from an ErrorMetadata
.
sourcepub fn meta(&self) -> &ErrorMetadata
pub fn meta(&self) -> &ErrorMetadata
Returns error metadata, which includes the error code, message, request ID, and potentially additional information.
sourcepub fn is_invalid_object_state(&self) -> bool
pub fn is_invalid_object_state(&self) -> bool
Returns true
if the error kind is GetObjectError::InvalidObjectState
.
sourcepub fn is_no_such_key(&self) -> bool
pub fn is_no_such_key(&self) -> bool
Returns true
if the error kind is GetObjectError::NoSuchKey
.
Trait Implementations§
source§impl CreateUnhandledError for GetObjectError
impl CreateUnhandledError for GetObjectError
source§fn create_unhandled_error(
source: Box<dyn Error + Send + Sync + 'static>,
meta: Option<ErrorMetadata>,
) -> Self
fn create_unhandled_error( source: Box<dyn Error + Send + Sync + 'static>, meta: Option<ErrorMetadata>, ) -> Self
source
and error metadata.source§impl Debug for GetObjectError
impl Debug for GetObjectError
source§impl Display for GetObjectError
impl Display for GetObjectError
source§impl Error for GetObjectError
impl Error for GetObjectError
source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
1.0.0 · source§fn description(&self) -> &str
fn description(&self) -> &str
source§impl From<GetObjectError> for Error
impl From<GetObjectError> for Error
source§fn from(err: GetObjectError) -> Self
fn from(err: GetObjectError) -> Self
source§impl ProvideErrorKind for GetObjectError
impl ProvideErrorKind for GetObjectError
source§impl ProvideErrorMetadata for GetObjectError
impl ProvideErrorMetadata for GetObjectError
source§fn meta(&self) -> &ErrorMetadata
fn meta(&self) -> &ErrorMetadata
source§impl RequestId for GetObjectError
impl RequestId for GetObjectError
source§fn request_id(&self) -> Option<&str>
fn request_id(&self) -> Option<&str>
None
if the service could not be reached.