EXECUTECHANGESET()`¶

About ExecuteChangeSet¶

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.

Method Signature¶

METHODS /AWS1/IF_FRM~EXECUTECHANGESET
  IMPORTING
    !IV_CHANGESETNAME TYPE /AWS1/FRMCHANGESETNAMEORID OPTIONAL
    !IV_STACKNAME TYPE /AWS1/FRMSTACKNAMEORID OPTIONAL
    !IV_CLIENTREQUESTTOKEN TYPE /AWS1/FRMCLIENTREQUESTTOKEN OPTIONAL
    !IV_DISABLEROLLBACK TYPE /AWS1/FRMDISABLEROLLBACK OPTIONAL
    !IV_RETAINEXCEPTONCREATE TYPE /AWS1/FRMRETAINEXCEPTONCREATE OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_frmexecutechangeset01
  RAISING
    /AWS1/CX_FRMCHANGESETNOTFNDEX
    /AWS1/CX_FRMINSUFFICIENTCAPA00
    /AWS1/CX_FRMINVCHANGESETSTATEX
    /AWS1/CX_FRMTOKENALRDYEXISTSEX
    /AWS1/CX_FRMCLIENTEXC
    /AWS1/CX_FRMSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_changesetname` `TYPE /AWS1/FRMCHANGESETNAMEORID` `/AWS1/FRMCHANGESETNAMEORID`¶

The name or Amazon Resource Name (ARN) of the change set that you want use to update the specified stack.

Optional arguments:¶

`iv_stackname` `TYPE /AWS1/FRMSTACKNAMEORID` `/AWS1/FRMSTACKNAMEORID`¶

If you specified the name of a change set, specify the stack name or Amazon Resource Name (ARN) that's associated with the change set you want to execute.

`iv_clientrequesttoken` `TYPE /AWS1/FRMCLIENTREQUESTTOKEN` `/AWS1/FRMCLIENTREQUESTTOKEN`¶

A unique identifier for this ExecuteChangeSet request. Specify this token if you plan to retry requests so that CloudFormation knows that you're not attempting to execute a change set to update a stack with the same name. You might retry ExecuteChangeSet requests to ensure that CloudFormation successfully received them.

`iv_disablerollback` `TYPE /AWS1/FRMDISABLEROLLBACK` `/AWS1/FRMDISABLEROLLBACK`¶

Preserves the state of previously provisioned resources when an operation fails. This parameter can't be specified when the OnStackFailure parameter to the CreateChangeSet API operation was specified.

True - if the stack creation fails, do nothing. This is equivalent to specifying DO_NOTHING for the OnStackFailure parameter to the CreateChangeSet API operation.

False - if the stack creation fails, roll back the stack. This is equivalent to specifying ROLLBACK for the OnStackFailure parameter to the CreateChangeSet API operation.

Default: True

`iv_retainexceptoncreate` `TYPE /AWS1/FRMRETAINEXCEPTONCREATE` `/AWS1/FRMRETAINEXCEPTONCREATE`¶

When set to true, newly created resources are deleted when the operation rolls back. This includes newly created resources marked with a deletion policy of Retain.

Default: false

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_frmexecutechangeset01` `/AWS1/CL_FRMEXECUTECHANGESET01`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->executechangeset(
  iv_changesetname = |string|
  iv_clientrequesttoken = |string|
  iv_disablerollback = ABAP_TRUE
  iv_retainexceptoncreate = ABAP_TRUE
  iv_stackname = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
ENDIF.

/AWS1/IF_FRM=>EXECUTECHANGESET()¶