Skip to content

Integrations

CloudFormation

Manage and inspect AWS CloudFormation stacks, resources, and drift

Use AWS CloudFormation to manage template-defined resource stacks. Create or update stacks, preview changes with change sets, inspect resources and events, and check drift or template validity from a workflow. Connect with a saved AWS credential.

Use the block

Create, update, and delete stacks, preview changes with change sets, describe stacks, list resources, detect drift, view stack events, and retrieve or validate templates.

Actions

CloudFormation Describe Stacks

List and describe CloudFormation stacks

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
stackNamestringNoStack name or ID to describe (omit to list all stacks)

Output

ParameterTypeDescription
stacksarrayList of CloudFormation stacks (stackName, stackId, stackStatus, stackStatusReason, detailedStatus, creationTime, lastUpdatedTime, deletionTime, description, enableTerminationProtection, driftInformation, outputs [{outputKey, outputValue, description, exportName}], tags, parameters [{parameterKey, parameterValue, usePreviousValue, resolvedValue}], capabilities, changeSetId, roleArn, parentId, rootId, notificationArns, timeoutInMinutes, disableRollback, deletionMode, retainExceptOnCreate)

CloudFormation Create Stack

Create a new CloudFormation stack from a template

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
stackNamestringYesName for the new stack (must be unique in the Region)
templateBodystringYesThe CloudFormation template body (JSON or YAML)
parametersjsonNoTemplate input parameters (e.g., [{"parameterKey": "InstanceType", "parameterValue": "t3.micro"}])
capabilitiesstringNoComma-separated capabilities to acknowledge (CAPABILITY_IAM, CAPABILITY_NAMED_IAM, CAPABILITY_AUTO_EXPAND) required when the template creates IAM resources or uses macros
tagsjsonNoTags to apply to the stack and its resources (e.g., [{"key": "env", "value": "prod"}])
onFailurestringNoAction to take on creation failure: ROLLBACK (default), DELETE, or DO_NOTHING
timeoutInMinutesnumberNoAmount of time before the stack creation times out and rolls back
roleArnstringNoARN of an IAM service role CloudFormation assumes for stack operations (defaults to the caller credentials or the role previously used for the stack)
enableTerminationProtectionbooleanNoWhether to enable termination protection on the new stack (default false)

Output

ParameterTypeDescription
stackIdstringThe unique ID of the created stack

CloudFormation Update Stack

Update an existing CloudFormation stack with a new or previous template

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
stackNamestringYesName or ID of the stack to update
templateBodystringNoThe new CloudFormation template body (JSON or YAML). Required unless usePreviousTemplate is true
usePreviousTemplatebooleanNoReuse the template currently associated with the stack instead of providing templateBody
parametersjsonNoTemplate input parameters (e.g., [{"parameterKey": "InstanceType", "parameterValue": "t3.micro"}])
capabilitiesstringNoComma-separated capabilities to acknowledge (CAPABILITY_IAM, CAPABILITY_NAMED_IAM, CAPABILITY_AUTO_EXPAND)
tagsjsonNoTags to apply to the stack and its resources (e.g., [{"key": "env", "value": "prod"}])
roleArnstringNoARN of an IAM service role CloudFormation assumes for stack operations (defaults to the caller credentials or the role previously used for the stack)

Output

ParameterTypeDescription
stackIdstringThe unique ID of the updated stack

CloudFormation Delete Stack

Delete a CloudFormation stack and its resources

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
stackNamestringYesName or ID of the stack to delete
retainResourcesstringNoComma-separated logical resource IDs to retain instead of deleting (only applies to stacks in DELETE_FAILED state)

Output

ParameterTypeDescription
messagestringOperation status message

CloudFormation Cancel Update Stack

Cancel an in-progress stack update and roll back to the last known stable state

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
stackNamestringYesName or ID of the stack whose update should be cancelled

Output

ParameterTypeDescription
messagestringOperation status message

CloudFormation Create Change Set

Preview the changes a stack create or update would make before applying them

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
stackNamestringYesName of the stack to create or update (new name for CREATE type, existing name for UPDATE)
changeSetNamestringYesName for the new change set
templateBodystringNoThe CloudFormation template body (JSON or YAML). Required unless usePreviousTemplate is true
usePreviousTemplatebooleanNoReuse the template currently associated with the stack (UPDATE change sets only)
parametersjsonNoTemplate input parameters (e.g., [{"parameterKey": "InstanceType", "parameterValue": "t3.micro"}])
capabilitiesstringNoComma-separated capabilities to acknowledge (CAPABILITY_IAM, CAPABILITY_NAMED_IAM, CAPABILITY_AUTO_EXPAND)
changeSetTypestringNoCREATE (default, new stack), UPDATE (existing stack), or IMPORT (import existing resources)
descriptionstringNoDescription of the change set for reference
tagsjsonNoTags to apply to the stack and its resources when the change set executes (e.g., [{"key": "env", "value": "prod"}])
roleArnstringNoARN of an IAM service role CloudFormation assumes for stack operations (defaults to the caller credentials or the role previously used for the stack)

Output

ParameterTypeDescription
changeSetIdstringThe unique ID of the created change set
stackIdstringThe unique ID of the target stack

CloudFormation Describe Change Set

View the resource changes a change set would make and its execution status

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
changeSetNamestringYesName or ARN of the change set to describe
stackNamestringNoName or ID of the stack the change set belongs to (required if changeSetName is not an ARN)
nextTokenstringNoPagination token from a previous call to fetch the next page of changes

Output

ParameterTypeDescription
changeSetNamestringName of the change set
changeSetIdstringThe unique ID of the change set
stackIdstringThe unique ID of the target stack
stackNamestringName of the target stack
descriptionstringDescription of the change set
executionStatusstringWhether the change set can be executed (AVAILABLE, UNAVAILABLE, EXECUTE_IN_PROGRESS, EXECUTE_COMPLETE, EXECUTE_FAILED, OBSOLETE)
statusstringCurrent status of the change set (CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_COMPLETE, DELETE_COMPLETE, FAILED)
statusReasonstringReason for the current status, particularly if failed
creationTimenumberTimestamp the change set was created
capabilitiesarrayCapabilities required to execute the change set
changesarrayList of resource changes (action, logicalResourceId, physicalResourceId, resourceType, replacement, type, policyAction, scope, changeSetId, details [{attribute, name, requiresRecreation, evaluation, changeSource, causingEntity}])
parametersarrayStack parameters for the change set (parameterKey, parameterValue, usePreviousValue, resolvedValue)
tagsarrayTags associated with the change set (key, value)
notificationArnsarraySNS topic ARNs that receive stack event notifications
includeNestedStacksbooleanWhether change sets were created for nested stacks
parentChangeSetIdstringID of the parent change set, for nested change sets
rootChangeSetIdstringID of the top-level change set, for nested change sets
onStackFailurestringBehavior when stack operations fail (DO_NOTHING, ROLLBACK, DELETE)
importExistingResourcesbooleanWhether the change set imports resources that already exist
nextTokenstringPagination token for the next page of changes, if more remain

CloudFormation Execute Change Set

Apply a previously created and reviewed change set to its stack

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
changeSetNamestringYesName or ARN of the change set to execute
stackNamestringNoName or ID of the stack the change set belongs to (required if changeSetName is not an ARN)

Output

ParameterTypeDescription
messagestringOperation status message

CloudFormation List Stack Resources

List all resources in a CloudFormation stack

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
stackNamestringYesStack name or ID

Output

ParameterTypeDescription
resourcesarrayList of stack resources with type, status, and drift information

CloudFormation Detect Stack Drift

Initiate drift detection on a CloudFormation stack

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
stackNamestringYesStack name or ID to detect drift on

Output

ParameterTypeDescription
stackDriftDetectionIdstringID to use with Describe Stack Drift Detection Status to check results

CloudFormation Describe Stack Drift Detection Status

Check the status of a stack drift detection operation

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
stackDriftDetectionIdstringYesThe drift detection ID returned by Detect Stack Drift

Output

ParameterTypeDescription
stackIdstringThe stack ID
stackDriftDetectionIdstringThe drift detection ID
stackDriftStatusstringDrift status (DRIFTED, IN_SYNC, NOT_CHECKED)
detectionStatusstringDetection status (DETECTION_IN_PROGRESS, DETECTION_COMPLETE, DETECTION_FAILED)
detectionStatusReasonstringReason if detection failed
driftedStackResourceCountnumberNumber of resources that have drifted
timestampnumberTimestamp of the detection

CloudFormation Describe Stack Events

Get the event history for a CloudFormation stack

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
stackNamestringYesStack name or ID
limitnumberNoMaximum number of events to return (default: 50)

Output

ParameterTypeDescription
eventsarrayList of stack events (stackId, eventId, stackName, operationId, logicalResourceId, physicalResourceId, resourceType, resourceStatus, resourceStatusReason, detailedStatus, resourceProperties, clientRequestToken, hookType, hookStatus, hookStatusReason, hookInvocationPoint, hookFailureMode, timestamp)

CloudFormation Get Template

Retrieve the template body for a CloudFormation stack

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
stackNamestringYesStack name or ID
templateStagestringNoWhich template version to retrieve: Processed (default, with transforms applied) or Original (as submitted)

Output

ParameterTypeDescription
templateBodystringThe template body as a JSON or YAML string
stagesAvailablearrayAvailable template stages

CloudFormation Get Template Summary

Get a summary of a template or deployed stack: resource types, required capabilities, and parameters, without full validation

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
templateBodystringNoThe CloudFormation template body (JSON or YAML). Required if stackName is not provided
stackNamestringNoName or ID of a deployed stack to summarize instead of a template body

Output

ParameterTypeDescription
descriptionstringTemplate description
parametersarrayTemplate parameters (parameterKey, defaultValue, parameterType, noEcho, description, allowedValues)
capabilitiesarrayRequired capabilities (e.g., CAPABILITY_IAM)
capabilitiesReasonstringReason capabilities are required
resourceTypesarrayAWS resource types declared in the template (e.g., AWS::S3::Bucket)
versionstringTemplate format version
declaredTransformsarrayTransforms used in the template (e.g., AWS::Serverless-2016-10-31)

CloudFormation Validate Template

Validate a CloudFormation template for syntax and structural correctness

Inputs and outputs

Input

ParameterTypeRequiredDescription
awsRegionstringYesAWS region (e.g., us-east-1)
templateBodystringYesThe CloudFormation template body (JSON or YAML)

Output

ParameterTypeDescription
descriptionstringTemplate description
parametersarrayTemplate parameters with defaults and descriptions
capabilitiesarrayRequired capabilities (e.g., CAPABILITY_IAM)
capabilitiesReasonstringReason capabilities are required
declaredTransformsarrayTransforms used in the template (e.g., AWS::Serverless-2016-10-31)
Was this helpful?
Suggest an edit