Skip to content
This repository has been archived by the owner on Dec 7, 2023. It is now read-only.

correcting update behavior descriptions #904

Merged
merged 1 commit into from
Jan 13, 2021
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions doc_source/using-cfn-updating-stacks-update-behaviors.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,13 @@
When you submit an update, AWS CloudFormation updates resources based on differences between what you submit and the stack's current template\. Resources that have not changed run without disruption during the update process\. For updated resources, AWS CloudFormation uses one of the following update behaviors:

Update with No Interruption <a name="update-no-interrupt"></a>
AWS CloudFormation updates the resource without disrupting operation of that resource and without changing the resource's physical ID\. For example, if you update any property on an [AWS::CloudTrail::Trail](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudtrail-trail.html) resource, AWS CloudFormation updates the trail without disruption\.
AWS CloudFormation updates the resource without disrupting operation of that resource and without changing the resource's physical ID\. For example, if you update certain properties on an [AWS::CloudTrail::Trail](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudtrail-trail.html) resource, AWS CloudFormation updates the trail without disruption\.

Updates with Some Interruption <a name="update-some-interrupt"></a>
AWS CloudFormation updates the resource with some interruption and retains the physical ID\. For example, if you update certain properties on an [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html) resource, the instance might have some interruption while AWS CloudFormation and Amazon EC2 reconfigure the instance\.
AWS CloudFormation updates the resource with some interruption\. For example, if you update certain properties on an [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html) resource, the instance might have some interruption while AWS CloudFormation and Amazon EC2 reconfigure the instance\.

Replacement <a name="update-replacement"></a>
AWS CloudFormation recreates the resource during an update, which also generates a new physical ID\. AWS CloudFormation creates the replacement resource first, changes references from other dependent resources to point to the replacement resource, and then deletes the old resource\. For example, if you update the `AvailabilityZone` property of an [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html) resource type, AWS CloudFormation creates a new resource and replaces the current EC2 Instance resource with the new one\.
AWS CloudFormation recreates the resource during an update, which also generates a new physical ID\. AWS CloudFormation usually creates the replacement resource first, changes references from other dependent resources to point to the replacement resource, and then deletes the old resource\. For example, if you update the `AvailabilityZone` property of an [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html) resource type, AWS CloudFormation creates a new resource and replaces the current EC2 Instance resource with the new one\.

The method AWS CloudFormation uses depends on which property you update for a given resource type\. The update behavior for each property is described in the [AWS Resource Types Reference](aws-template-resource-type-ref.md)\.

Expand All @@ -22,4 +22,4 @@ Depending on the update behavior, you can decide when to modify resources to red
This example is not exhaustive; it's meant to give you an idea of the things to plan for when a resource is replaced during an update\.

**Note**
If the template includes one or more [nested stacks](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html), AWS CloudFormation also initiates an update for every nested stack\. This is necessary to determine whether the nested stacks have been modified\. AWS CloudFormation updates only those resources in the nested stacks that have changes specified in corresponding templates\.
If the template includes one or more [nested stacks](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html), AWS CloudFormation also initiates an update for every nested stack\. This is necessary to determine whether the nested stacks have been modified\. AWS CloudFormation updates only those resources in the nested stacks that have changes specified in corresponding templates\.