AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Table Of Contents

Feedback

[ aws . cloudformation ]

describe-stack-events

Description

Returns all stack related events for a specified stack. For more information about a stack's event history, go to Stacks in the AWS CloudFormation User Guide.

Note

Events are returned, even if the stack never existed or has been successfully deleted.

Synopsis

  describe-stack-events
--stack-name <value>
[--starting-token <value>]
[--max-items <value>]

Options

--stack-name (string)

The name or the unique identifier associated with the stack.

Default: There is no default value.

--starting-token (string)

A token to specify where to start paginating. This is the --next-token from a previously truncated response.

--max-items (integer)

The total number of items to return. If the total number of items available is more than the value specified in max-items then a --next-token will be provided in the output that you can use to resume pagination.

Output

StackEvents -> (list)

A list of StackEvents structures.

(structure)

The StackEvent data type.

StackId -> (string)

The unique ID name of the instance of the stack.

EventId -> (string)

The unique ID of this event.

StackName -> (string)

The name associated with a stack.

LogicalResourceId -> (string)

The logical name of the resource specified in the template.

PhysicalResourceId -> (string)

The name or unique identifier associated with the physical instance of the resource.

ResourceType -> (string)

Type of resource. (For more information, go to AWS Resource Types Reference in the AWS CloudFormation User Guide.)

Timestamp -> (timestamp)

Time the status was updated.

ResourceStatus -> (string)

Current status of the resource.

ResourceStatusReason -> (string)

Success/failure message associated with the resource.

ResourceProperties -> (string)

BLOB of the properties used to create the resource.

NextToken -> (string)

String that identifies the start of the next list of events, if there is one.