Struct StackFailure

pub struct StackFailure {
    pub stack_id: String,
    pub stack_status: StackStatus,
    pub stack_status_reason: String,
    pub resource_events: Vec<(ResourceStatus, StackEventDetails)>,
}

Describes a failed stack operation.

This error tries to capture enough information to quickly identify the root-cause of the operation’s failure (such as not having permission to create or update a particular resource in the stack). stack_status_reason and StackEventDetails::resource_status_reason may be useful for this purpose.

Fields

stack_id: String

The ID of the stack.

stack_status: StackStatus

The failed status in which the stack settled.

stack_status_reason: String

The first reason the stack moved into a failing state.

Note that this may not be the reason associated with the current stack_status, but rather the reason for the first negative status the stack entered (which is usually more descriptive).

resource_events: Vec<(ResourceStatus, StackEventDetails)>

Resource events with negative statuses that may have precipitated the failure of the operation.

Note: this is represented as a Vec or tuples to avoid having to worry about matching StackEvent variants (when it would be a logical error for them to be anything other than the Resource variant).

Implementations

impl StackFailure

pub fn stack_status_reason(&self) -> StatusReason<'_>

The first reason the stack moved into a failing state.

Trait Implementations

impl Debug for StackFailure

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

Formats the value using the given formatter.

impl Display for StackFailure

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

Formats the value using the given formatter.