Struct AwsError 

pub struct AwsError {
    pub status: StatusCode,
    pub code: String,
    pub message: String,
    pub error_type: ErrorType,
    pub extras: Option<Box<Map<String, Value>>>,
}

Represents an AWS API error response.

Fields

status: StatusCode

HTTP status code (e.g., 404, 400, 500)

code: String

AWS error code (e.g., “NoSuchBucket”, “ResourceNotFoundException”)

message: String

Human-readable error message

error_type: ErrorType

Error type: “Sender” (client error) or “Receiver” (server error)

extras: Option<Box<Map<String, Value>>>

Extra JSON fields merged into the serialized error body.

Some AWS exceptions carry structured data alongside the standard __type / message envelope — for example, DynamoDB’s TransactionCanceledException includes a CancellationReasons array, and ConditionalCheckFailedException may include the existing Item. Use Self::with_extras or Self::with_extra to attach them.

Boxed to keep AwsError small enough to fit comfortably in a Result<_, AwsError> (clippy’s result_large_err threshold).

Implementations

impl AwsError

pub fn not_found(code: impl Into<String>, message: impl Into<String>) -> Self

pub fn service_not_found( code: impl Into<String>, message: impl Into<String>, ) -> Self

Service-level “resource not found” error returned with HTTP 400.

Many JSON-protocol services (DynamoDB, KMS, SecretsManager, Cognito, …) model ResourceNotFoundException and friends as client-side validation errors and respond with 400 Bad Request rather than 404 Not Found. Use this constructor for those cases; reserve Self::not_found for REST-style 404s such as S3’s NoSuchBucket / NoSuchKey.

pub fn bad_request(code: impl Into<String>, message: impl Into<String>) -> Self

pub fn conflict(code: impl Into<String>, message: impl Into<String>) -> Self

pub fn internal(message: impl Into<String>) -> Self

pub fn not_implemented(operation: &str) -> Self

pub fn unknown_operation(operation: &str) -> Self

pub fn access_denied(message: impl Into<String>) -> Self

pub fn access_denied_for( action: &str, principal_arn: &str, resource: &str, ) -> Self

pub fn validation(message: impl Into<String>) -> Self

pub fn with_extras(self, extras: Map<String, Value>) -> Self

Replace the extras map wholesale.

pub fn with_extra(self, key: impl Into<String>, value: Value) -> Self

Insert a single extra field, allocating the map if needed.

Trait Implementations

impl Clone for AwsError

fn clone(&self) -> AwsError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AwsError

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

Formats the value using the given formatter.

impl Display for AwsError

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

Formats the value using the given formatter.

impl Error for AwsError

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 Serialize for AwsError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.