# StackEvent
<a name="API_StackEvent"></a>

The `StackEvent` data type.

## Contents
<a name="API_StackEvent_Contents"></a>

 ** EventId **   
The unique identifier of this event.  
Type: String  
Required: Yes

 ** StackId **   
The unique ID name of the instance of the stack.  
Type: String  
Required: Yes

 ** StackName **   
The name associated with a stack.  
Type: String  
Required: Yes

 ** Timestamp **   
Time the status was updated.  
Type: Timestamp  
Required: Yes

 ** ClientRequestToken **   
The token passed to the operation that generated this event.  
All events triggered by a given stack operation are assigned the same client request token, which you can use to track operations. For example, if you execute a `CreateStack` operation with the token `token1`, then all the `StackEvents` generated by that operation will have `ClientRequestToken` set as `token1`.  
In the console, stack operations display the client request token on the Events tab. Stack operations that are initiated from the console use the token format *Console-StackOperation-ID*, which helps you easily identify the stack operation . For example, if you create a stack using the console, each stack event would be assigned the same token in the following format: `Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002`.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `[a-zA-Z0-9][-a-zA-Z0-9]*`   
Required: No

 ** DetailedStatus **   
An optional field that contains information about the detailed status of the stack event.  
+  `CONFIGURATION_COMPLETE` - all of the resources in the stack have reached that event. For more information, see [Understand CloudFormation stack creation events](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-resource-configuration-complete.html) in the * AWS CloudFormation User Guide*.
+  `VALIDATION_FAILED` - template validation failed because of invalid properties in the template. The `ResourceStatusReason` field shows what properties are defined incorrectly.
Type: String  
Valid Values: `CONFIGURATION_COMPLETE | VALIDATION_FAILED`   
Required: No

 ** HookFailureMode **   
Specify the Hook failure mode for non-compliant resources in the followings ways.  
+  `FAIL` Stops provisioning resources.
+  `WARN` Allows provisioning to continue with a warning message.
Type: String  
Valid Values: `FAIL | WARN`   
Required: No

 ** HookInvocationId **   
The unique identifier of the Hook invocation.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

 ** HookInvocationPoint **   
The specific point in the provisioning process where the Hook is invoked.  
Type: String  
Valid Values: `PRE_PROVISION`   
Required: No

 ** HookStatus **   
Provides the status of the change set Hook.  
Type: String  
Valid Values: `HOOK_IN_PROGRESS | HOOK_COMPLETE_SUCCEEDED | HOOK_COMPLETE_FAILED | HOOK_FAILED`   
Required: No

 ** HookStatusReason **   
Provides the reason for the Hook status.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** HookType **   
The name of the Hook.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** LogicalResourceId **   
The logical name of the resource specified in the template.  
Type: String  
Required: No

 ** OperationId **   
The unique identifier of the operation that generated this stack event.  
Type: String  
Required: No

 ** PhysicalResourceId **   
The name or unique identifier associated with the physical instance of the resource.  
Type: String  
Required: No

 ** ResourceProperties **   
BLOB of the properties used to create the resource.  
Type: String  
Required: No

 ** ResourceStatus **   
Current status of the resource.  
Type: String  
Valid Values: `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | DELETE_SKIPPED | UPDATE_IN_PROGRESS | UPDATE_FAILED | UPDATE_COMPLETE | IMPORT_FAILED | IMPORT_COMPLETE | IMPORT_IN_PROGRESS | IMPORT_ROLLBACK_IN_PROGRESS | IMPORT_ROLLBACK_FAILED | IMPORT_ROLLBACK_COMPLETE | EXPORT_FAILED | EXPORT_COMPLETE | EXPORT_IN_PROGRESS | EXPORT_ROLLBACK_IN_PROGRESS | EXPORT_ROLLBACK_FAILED | EXPORT_ROLLBACK_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE | UPDATE_ROLLBACK_FAILED | ROLLBACK_IN_PROGRESS | ROLLBACK_COMPLETE | ROLLBACK_FAILED`   
Required: No

 ** ResourceStatusReason **   
Success/failure message associated with the resource.  
Type: String  
Required: No

 ** ResourceType **   
Type of resource. For more information, see [AWS resource and property types reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) in the * AWS CloudFormation User Guide*.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.  
Required: No

## See Also
<a name="API_StackEvent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/cloudformation-2010-05-15/StackEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/cloudformation-2010-05-15/StackEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/cloudformation-2010-05-15/StackEvent)