AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Updates a stack using the input information that was provided when the specified change set was created. After the call successfully completes, CloudFormation starts updating the stack. Use the DescribeStacks action to view the status of the update.

When you execute a change set, CloudFormation deletes all other change sets associated with the stack because they aren't valid for the updated stack.

If a stack policy is associated with the stack, CloudFormation enforces the policy during the update. You can't specify a temporary stack policy that overrides the current policy.

To create a change set for the entire stack hierarchy, IncludeNestedStacks must have been set to True.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginExecuteChangeSet and EndExecuteChangeSet.

Namespace: Amazon.CloudFormation
Assembly: AWSSDK.CloudFormation.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<ExecuteChangeSetResponse> ExecuteChangeSetAsync(
         ExecuteChangeSetRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.CloudFormation.Model.ExecuteChangeSetRequest

Container for the necessary parameters to execute the ExecuteChangeSet service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the ExecuteChangeSet service method, as returned by CloudFormation.

Exceptions

ExceptionCondition
ChangeSetNotFoundException The specified change set name or ID doesn't exit. To view valid change sets for a stack, use the ListChangeSets operation.
InsufficientCapabilitiesException The template contains resources with capabilities that weren't specified in the Capabilities parameter.
InvalidChangeSetStatusException The specified change set can't be used to update the stack. For example, the change set status might be CREATE_IN_PROGRESS, or the stack status might be UPDATE_IN_PROGRESS.
TokenAlreadyExistsException A client request token already exists.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also