Skip to content

CloudFormation  >  Operations  >  describe_stack_events

describe_stack_events

Operation

describe_stack_events async

describe_stack_events(input: DescribeStackEventsInput, plugins: list[Plugin] | None = None) -> DescribeStackEventsOutput

Returns all stack related events for a specified stack in reverse chronological order. For more information about a stack's event history, see Understand CloudFormation stack creation events in the CloudFormation User Guide.

Note

You can list events for stacks that have failed to create or have been deleted by specifying the unique stack identifier (stack ID).

Parameters:

Name Type Description Default
input DescribeStackEventsInput

An instance of DescribeStackEventsInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
DescribeStackEventsOutput

An instance of DescribeStackEventsOutput.

Input

DescribeStackEventsInput dataclass

Bases: _SerdeShape

The input for DescribeStackEvents action.

Attributes

next_token class-attribute instance-attribute
next_token: str | None = ...

The token for the next set of items to return. (You received this token from a previous call.)

stack_name class-attribute instance-attribute
stack_name: str | None = ...

The name or the unique stack ID that's associated with the stack, which aren't always interchangeable:

  • Running stacks: You can specify either the stack's name or its unique stack ID.

  • Deleted stacks: You must specify the unique stack ID.

Output

DescribeStackEventsOutput dataclass

Bases: _SerdeShape

The output for a DescribeStackEvents action.

Attributes

next_token class-attribute instance-attribute
next_token: str | None = ...

If the output exceeds 1 MB in size, a string that identifies the next page of events. If no additional page exists, this value is null.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

stack_events class-attribute instance-attribute
stack_events: list[StackEvent] | None = ...

A list of StackEvents structures.