Request Parameters Response Elements Errors Examples See Also

DescribeStackEvents

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 AWS 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).

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

NextToken

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

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

StackName

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.

Type: String

Required: Yes

Response Elements

The following elements are returned by the service.

NextToken

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.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

StackEvents.member.N

A list of StackEvents structures.

Type: Array of StackEvent objects

Errors

For information about the errors that are common to all actions, see Common Error Types.

Examples

DescribeStackEvents

This example illustrates one usage of DescribeStackEvents.

Sample Request



            https://cloudformation.us-east-1.amazonaws.com/
 ?Action=DescribeStackEvents
 &StackName=MyStack
 &Version=2010-05-15
 &X-Amz-Algorithm=AWS4-HMAC-SHA256
 &X-Amz-Credential=[Access key ID and scope]
 &X-Amz-Date=20160316T233349Z
 &X-Amz-SignedHeaders=content-type;host
 &X-Amz-Signature=[Signature]

Sample Response




  
    
      
        2016-03-15T20:54:31.809Z
        CREATE_COMPLETE
        arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/12a3b456-0e10-4ce0-9052-5d484a8c4e5b
        1dedea10-eaf0-11e5-8451-500c5242948e
        SampleStack
        SampleStack
        arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/12a3b456-0e10-4ce0-9052-5d484a8c4e5b
        AWS::CloudFormation::Stack
      
      
        2016-03-15T20:54:30.174Z
        CREATE_COMPLETE
        arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/12a3b456-0e10-4ce0-9052-5d484a8c4e5b
        MyEC2Instance-CREATE_COMPLETE-2016-03-15T20:54:30.174Z
        MyEC2Instance
        SampleStack
        i-1abc23d4
        {"ImageId":ami-8fcee4e5",...}
        AWS::EC2::Instance
      
      
        2016-03-15T20:53:17.660Z
        CREATE_IN_PROGRESS
        arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/12a3b456-0e10-4ce0-9052-5d484a8c4e5b
        MyEC2Instance-CREATE_IN_PROGRESS-2016-03-15T20:53:17.660Z
        MyEC2Instance
        Resource creation Initiated
        SampleStack
        i-1abc23d4
        {"ImageId":ami-8fcee4e5",...}
        AWS::EC2::Instance
      
      
        2016-03-15T20:53:16.516Z
        CREATE_IN_PROGRESS
        arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/12a3b456-0e10-4ce0-9052-5d484a8c4e5b
        MyEC2Instance-CREATE_IN_PROGRESS-2016-03-15T20:53:16.516Z
        MyEC2Instance
        SampleStack
        
        {"ImageId":ami-8fcee4e5",...}
        AWS::EC2::Instance
      
      
        2016-03-15T20:53:11.231Z
        CREATE_IN_PROGRESS
        arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/12a3b456-0e10-4ce0-9052-5d484a8c4e5b
        edbf2ac0-eaef-11e5-adeb-500c28903236
        SampleStack
        User Initiated
        SampleStack
        arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/12a3b456-0e10-4ce0-9052-5d484a8c4e5b
        AWS::CloudFormation::Stack
      
    
  
  
    b9b4b068-3a41-11e5-94eb-example