# CfnStackProps

Properties for defining a `CfnStack`.

Extends: CfnStackProps
Used as props by: CfnStack

- Source: Generated code
- Type last changed: v2.106.0 · 10 Nov 2023

## 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 cfnStackProps: cloudformation.CfnStackProps = {
  notificationArns: ['notificationArns'],
  parameters: {
    parametersKey: 'parameters',
  },
  tags: [{
    key: 'key',
    value: 'value',
  }],
  templateUrl: 'templateUrl',
  timeoutInMinutes: 123,
};
```

## Properties

- `notificationArns`: string[] — The Amazon SNS topic ARNs to publish stack related events.

  You can find your Amazon SNS topic ARNs using the Amazon SNS console or your Command Line Interface (CLI).

- `parameters`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | { [key: string]: string } — The set value pairs that represent the parameters passed to CloudFormation when this nested stack is created.

  Each parameter has a name corresponding to a parameter defined in the embedded template and a value representing the value that you want to set for the parameter.

  > If you use the `Ref` function to pass a parameter value to a nested stack, comma-delimited list parameters must be of type `String` . In other words, you can't pass values that are of type `CommaDelimitedList` to nested stacks.

  Required if the nested stack requires input parameters.

  Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.

- `tags`: [CfnTag](/cdk/api/v2/docs/aws-cdk-lib.CfnTag.html)[] — Key-value pairs to associate with this stack.

  CloudFormation also propagates these tags to the resources created in the stack. A maximum number of 50 tags can be specified.

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

  The URL must point to a template (max size: 1 MB) that's located in an Amazon S3 bucket. The location for an Amazon S3 bucket must start with `https://` .

  Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.

- `timeoutInMinutes`: number — The length of time, in minutes, that CloudFormation waits for the nested stack to reach the `CREATE_COMPLETE` state.

  The default is no timeout. When CloudFormation detects that the nested stack has reached the `CREATE_COMPLETE` state, it marks the nested stack resource as `CREATE_COMPLETE` in the parent stack and resumes creating the parent stack. If the timeout period expires before the nested stack reaches `CREATE_COMPLETE` , CloudFormation marks the nested stack as failed and rolls back both the nested stack and parent stack.

  Updates aren't supported.