---
title: Getting Started with Datadog
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Infrastructure > Datadog Resource Catalog
---

# aws_cloudformation_stack{% #aws_cloudformation_stack %}

## `account_id`{% #account_id %}

**Type**: `STRING`

## `capabilities`{% #capabilities %}

**Type**: `UNORDERED_LIST_STRING`**Provider name**: `Capabilities`**Description**: The capabilities allowed in the stack.

## `change_set_id`{% #change_set_id %}

**Type**: `STRING`**Provider name**: `ChangeSetId`**Description**: The unique ID of the change set.

## `creation_time`{% #creation_time %}

**Type**: `TIMESTAMP`**Provider name**: `CreationTime`**Description**: The time at which the stack was created.

## `deletion_mode`{% #deletion_mode %}

**Type**: `STRING`**Provider name**: `DeletionMode`**Description**: Specifies the deletion mode for the stack. Possible values are:

- `STANDARD` - Use the standard behavior. Specifying this value is the same as not specifying this parameter.
- `FORCE_DELETE_STACK` - Delete the stack if it's stuck in a `DELETE_FAILED` state due to resource deletion failure.



## `deletion_time`{% #deletion_time %}

**Type**: `TIMESTAMP`**Provider name**: `DeletionTime`**Description**: The time the stack was deleted.

## `description`{% #description %}

**Type**: `STRING`**Provider name**: `Description`**Description**: A user-defined description associated with the stack.

## `detailed_status`{% #detailed_status %}

**Type**: `STRING`**Provider name**: `DetailedStatus`**Description**: The detailed status of the resource or stack. If `CONFIGURATION_COMPLETE` is present, the resource or resource configuration phase has completed and the stabilization of the resources is in progress. The stack sets `CONFIGURATION_COMPLETE` when all of the resources in the stack have reached that event. For more information, see [CloudFormation stack deployment](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-resource-configuration-complete.html) in the CloudFormation User Guide.

## `disable_rollback`{% #disable_rollback %}

**Type**: `BOOLEAN`**Provider name**: `DisableRollback`**Description**: Boolean to enable or disable rollback on stack creation failures:

- `true`: disable rollback.
- `false`: enable rollback.



## `drift_information`{% #drift_information %}

**Type**: `STRUCT`**Provider name**: `DriftInformation`**Description**: Information about whether a stack's actual configuration differs, or has drifted, from its expected configuration, as defined in the stack template and any values specified as template parameters. For more information, see [Detecting Unregulated Configuration Changes to Stacks and Resources](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html).

- `last_check_timestamp`**Type**: `TIMESTAMP`**Provider name**: `LastCheckTimestamp`**Description**: Most recent time when a drift detection operation was initiated on the stack, or any of its individual resources that support drift detection.
- `stack_drift_status`**Type**: `STRING`**Provider name**: `StackDriftStatus`**Description**: Status of the stack's actual configuration compared to its expected template configuration.
  - `DRIFTED`: The stack differs from its expected template configuration. A stack is considered to have drifted if one or more of its resources have drifted.
  - `NOT_CHECKED`: CloudFormation hasn't checked if the stack differs from its expected template configuration.
  - `IN_SYNC`: The stack's actual configuration matches its expected template configuration.
  - `UNKNOWN`: This value is reserved for future use.

## `enable_termination_protection`{% #enable_termination_protection %}

**Type**: `BOOLEAN`**Provider name**: `EnableTerminationProtection`**Description**: Whether termination protection is enabled for the stack. For [nested stacks](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html), termination protection is set on the root stack and can't be changed directly on the nested stack. For more information, see [Protecting a Stack From Being Deleted](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html) in the CloudFormation User Guide.

## `last_updated_time`{% #last_updated_time %}

**Type**: `TIMESTAMP`**Provider name**: `LastUpdatedTime`**Description**: The time the stack was last updated. This field will only be returned if the stack has been updated at least once.

## `notification_arns`{% #notification_arns %}

**Type**: `UNORDERED_LIST_STRING`**Provider name**: `NotificationARNs`**Description**: Amazon SNS topic Amazon Resource Names (ARNs) to which stack related events are published.

## `outputs`{% #outputs %}

**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `Outputs`**Description**: A list of output structures.

- `description`**Type**: `STRING`**Provider name**: `Description`**Description**: User defined description associated with the output.
- `export_name`**Type**: `STRING`**Provider name**: `ExportName`**Description**: The name of the export associated with the output.
- `output_key`**Type**: `STRING`**Provider name**: `OutputKey`**Description**: The key associated with the output.
- `output_value`**Type**: `STRING`**Provider name**: `OutputValue`**Description**: The value associated with the output.

## `parameters`{% #parameters %}

**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `Parameters`**Description**: A list of `Parameter` structures.

- `parameter_key`**Type**: `STRING`**Provider name**: `ParameterKey`**Description**: The key associated with the parameter. If you don't specify a key and value for a particular parameter, CloudFormation uses the default value that's specified in your template.
- `parameter_value`**Type**: `STRING`**Provider name**: `ParameterValue`**Description**: The input value associated with the parameter.
- `resolved_value`**Type**: `STRING`**Provider name**: `ResolvedValue`**Description**: Read-only. The value that corresponds to a SSM parameter key. This field is returned only for [SSM](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html#aws-ssm-parameter-types) parameter types in the template.
- `use_previous_value`**Type**: `BOOLEAN`**Provider name**: `UsePreviousValue`**Description**: During a stack update, use the existing parameter value that the stack is using for a given parameter key. If you specify `true`, do not specify a parameter value.

## `parent_id`{% #parent_id %}

**Type**: `STRING`**Provider name**: `ParentId`**Description**: For nested stacks–stacks created as resources for another stack–the stack ID of the direct parent of this stack. For the first level of nested stacks, the root stack is also the parent stack. For more information, see [Working with Nested Stacks](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html) in the CloudFormation User Guide.

## `retain_except_on_create`{% #retain_except_on_create %}

**Type**: `BOOLEAN`**Provider name**: `RetainExceptOnCreate`**Description**: When set to `true`, newly created resources are deleted when the operation rolls back. This includes newly created resources marked with a deletion policy of `Retain`.**Default**: `false`

## `role_arn`{% #role_arn %}

**Type**: `STRING`**Provider name**: `RoleARN`**Description**: The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that's associated with the stack. During a stack operation, CloudFormation uses this role's credentials to make calls on your behalf.

## `rollback_configuration`{% #rollback_configuration %}

**Type**: `STRUCT`**Provider name**: `RollbackConfiguration`**Description**: The rollback triggers for CloudFormation to monitor during stack creation and updating operations, and for the specified monitoring period afterwards.

- `monitoring_time_in_minutes`**Type**: `INT32`**Provider name**: `MonitoringTimeInMinutes`**Description**: The amount of time, in minutes, during which CloudFormation should monitor all the rollback triggers after the stack creation or update operation deploys all necessary resources. The default is 0 minutes. If you specify a monitoring period but don't specify any rollback triggers, CloudFormation still waits the specified period of time before cleaning up old resources after update operations. You can use this monitoring period to perform any manual stack validation desired, and manually cancel the stack creation or update (using [CancelUpdateStack](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CancelUpdateStack.html), for example) as necessary. If you specify 0 for this parameter, CloudFormation still monitors the specified rollback triggers during stack creation and update operations. Then, for update operations, it begins disposing of old resources immediately once the operation completes.
- `rollback_triggers`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `RollbackTriggers`**Description**: The triggers to monitor during stack creation or update actions. By default, CloudFormation saves the rollback triggers specified for a stack and applies them to any subsequent update operations for the stack, unless you specify otherwise. If you do specify rollback triggers for this parameter, those triggers replace any list of triggers previously specified for the stack. This means:
  - To use the rollback triggers previously specified for this stack, if any, don't specify this parameter.
  - To specify new or updated rollback triggers, you must specify all the triggers that you want used for this stack, even triggers you've specified before (for example, when creating the stack or during a previous stack update). Any triggers that you don't include in the updated list of triggers are no longer applied to the stack.
  - To remove all currently specified triggers, specify an empty list for this parameter.
If a specified trigger is missing, the entire stack operation fails and is rolled back.
  - `arn`**Type**: `STRING`**Provider name**: `Arn`**Description**: The Amazon Resource Name (ARN) of the rollback trigger. If a specified trigger is missing, the entire stack operation fails and is rolled back.
  - `type`**Type**: `STRING`**Provider name**: `Type`**Description**: The resource type of the rollback trigger. Specify either [AWS::CloudWatch::Alarm](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cw-alarm.html) or [AWS::CloudWatch::CompositeAlarm](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-compositealarm.html) resource types.

## `root_id`{% #root_id %}

**Type**: `STRING`**Provider name**: `RootId`**Description**: For nested stacks–stacks created as resources for another stack–the stack ID of the top-level stack to which the nested stack ultimately belongs. For more information, see [Working with Nested Stacks](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html) in the CloudFormation User Guide.

## `stack_id`{% #stack_id %}

**Type**: `STRING`**Provider name**: `StackId`**Description**: Unique identifier of the stack.

## `stack_name`{% #stack_name %}

**Type**: `STRING`**Provider name**: `StackName`**Description**: The name associated with the stack.

## `stack_status`{% #stack_status %}

**Type**: `STRING`**Provider name**: `StackStatus`**Description**: Current status of the stack.

## `stack_status_reason`{% #stack_status_reason %}

**Type**: `STRING`**Provider name**: `StackStatusReason`**Description**: Success/failure message associated with the stack status.

## `tags`{% #tags %}

**Type**: `UNORDERED_LIST_STRING`

## `timeout_in_minutes`{% #timeout_in_minutes %}

**Type**: `INT32`**Provider name**: `TimeoutInMinutes`**Description**: The amount of time within which stack creation should complete.
