# CfnChangeSetProps

Properties for defining a `CfnChangeSet`.

Extends: CfnChangeSetProps
Used as props by: CfnChangeSet

- Source: Generated code
- Type last changed: v2.268.0 · 2 Sep 2026

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_cloudformation as cloudformation } from 'aws-cdk-lib';
const cfnChangeSetProps: cloudformation.CfnChangeSetProps = {
  changeSetName: 'changeSetName',
  stackName: 'stackName',

  // the properties below are optional
  capabilities: ['capabilities'],
  changeSetType: 'changeSetType',
  deploymentMode: 'deploymentMode',
  description: 'description',
  importExistingResources: false,
  includeNestedStacks: false,
  notificationArns: ['notificationArns'],
  onStackFailure: 'onStackFailure',
  roleArn: 'roleArn',
  tags: [{
    key: 'key',
    value: 'value',
  }],
  templateBody: 'templateBody',
  templateUrl: 'templateUrl',
  usePreviousTemplate: false,
};
```

## Properties

- `capabilities`: string[] — The capabilities that are allowed in the stack.

- `changeSetName`: string (required) — The name of the change set.

  Must be unique among all change sets associated with the specified stack.

- `changeSetType`: string — The type of change set operation.

- `deploymentMode`: string — Determines how CloudFormation handles configuration drift during deployment.

- `description`: string — A description to help you identify this change set.

- `importExistingResources`: boolean | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) — Indicates if the change set imports resources that already exist.

- `includeNestedStacks`: boolean | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) — Creates a change set for all nested stacks specified in the template.

- `notificationArns`: string[] — The ARNs of Amazon SNS topics that CloudFormation associates with the stack.

- `onStackFailure`: string — Determines what action will be taken if stack creation fails.

- `roleArn`: string — The ARN of an IAM role that CloudFormation assumes when executing the change set.

- `stackName`: string (required) — The name or unique ID of the stack for which you are creating a change set.

- `tags`: [CfnChangeSet.TagsItemsProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_cloudformation.CfnChangeSet.TagsItemsProperty.html)[] — Key-value pairs to associate with the change set.

- `templateBody`: string — A structure that contains the body of the revised template.

- `templateUrl`: string — The URL of the file that contains the revised template.

- `usePreviousTemplate`: boolean | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) — Whether to reuse the template associated with the stack to create the change set.