/** * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * SPDX-License-Identifier: Apache-2.0. */ #pragma once #include #include #include #include #include #include #include #include #include namespace Aws { namespace CloudFormation { namespace Model { /** *

The input for an UpdateStack action.

See Also:

AWS * API Reference

*/ class UpdateStackRequest : public CloudFormationRequest { public: AWS_CLOUDFORMATION_API UpdateStackRequest(); // Service request name is the Operation name which will send this request out, // each operation should has unique request name, so that we can get operation's name from this request. // Note: this is not true for response, multiple operations may have the same response name, // so we can not get operation's name from response. inline virtual const char* GetServiceRequestName() const override { return "UpdateStack"; } AWS_CLOUDFORMATION_API Aws::String SerializePayload() const override; protected: AWS_CLOUDFORMATION_API void DumpBodyToUrl(Aws::Http::URI& uri ) const override; public: /** *

The name or unique stack ID of the stack to update.

*/ inline const Aws::String& GetStackName() const{ return m_stackName; } /** *

The name or unique stack ID of the stack to update.

*/ inline bool StackNameHasBeenSet() const { return m_stackNameHasBeenSet; } /** *

The name or unique stack ID of the stack to update.

*/ inline void SetStackName(const Aws::String& value) { m_stackNameHasBeenSet = true; m_stackName = value; } /** *

The name or unique stack ID of the stack to update.

*/ inline void SetStackName(Aws::String&& value) { m_stackNameHasBeenSet = true; m_stackName = std::move(value); } /** *

The name or unique stack ID of the stack to update.

*/ inline void SetStackName(const char* value) { m_stackNameHasBeenSet = true; m_stackName.assign(value); } /** *

The name or unique stack ID of the stack to update.

*/ inline UpdateStackRequest& WithStackName(const Aws::String& value) { SetStackName(value); return *this;} /** *

The name or unique stack ID of the stack to update.

*/ inline UpdateStackRequest& WithStackName(Aws::String&& value) { SetStackName(std::move(value)); return *this;} /** *

The name or unique stack ID of the stack to update.

*/ inline UpdateStackRequest& WithStackName(const char* value) { SetStackName(value); return *this;} /** *

Structure containing the template body with a minimum length of 1 byte and a * maximum length of 51,200 bytes. (For more information, go to Template * Anatomy in the CloudFormation User Guide.)

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline const Aws::String& GetTemplateBody() const{ return m_templateBody; } /** *

Structure containing the template body with a minimum length of 1 byte and a * maximum length of 51,200 bytes. (For more information, go to Template * Anatomy in the CloudFormation User Guide.)

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline bool TemplateBodyHasBeenSet() const { return m_templateBodyHasBeenSet; } /** *

Structure containing the template body with a minimum length of 1 byte and a * maximum length of 51,200 bytes. (For more information, go to Template * Anatomy in the CloudFormation User Guide.)

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline void SetTemplateBody(const Aws::String& value) { m_templateBodyHasBeenSet = true; m_templateBody = value; } /** *

Structure containing the template body with a minimum length of 1 byte and a * maximum length of 51,200 bytes. (For more information, go to Template * Anatomy in the CloudFormation User Guide.)

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline void SetTemplateBody(Aws::String&& value) { m_templateBodyHasBeenSet = true; m_templateBody = std::move(value); } /** *

Structure containing the template body with a minimum length of 1 byte and a * maximum length of 51,200 bytes. (For more information, go to Template * Anatomy in the CloudFormation User Guide.)

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline void SetTemplateBody(const char* value) { m_templateBodyHasBeenSet = true; m_templateBody.assign(value); } /** *

Structure containing the template body with a minimum length of 1 byte and a * maximum length of 51,200 bytes. (For more information, go to Template * Anatomy in the CloudFormation User Guide.)

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline UpdateStackRequest& WithTemplateBody(const Aws::String& value) { SetTemplateBody(value); return *this;} /** *

Structure containing the template body with a minimum length of 1 byte and a * maximum length of 51,200 bytes. (For more information, go to Template * Anatomy in the CloudFormation User Guide.)

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline UpdateStackRequest& WithTemplateBody(Aws::String&& value) { SetTemplateBody(std::move(value)); return *this;} /** *

Structure containing the template body with a minimum length of 1 byte and a * maximum length of 51,200 bytes. (For more information, go to Template * Anatomy in the CloudFormation User Guide.)

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline UpdateStackRequest& WithTemplateBody(const char* value) { SetTemplateBody(value); return *this;} /** *

Location of file containing the template body. The URL must point to a * template that's located in an Amazon S3 bucket or a Systems Manager document. * For more information, go to Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline const Aws::String& GetTemplateURL() const{ return m_templateURL; } /** *

Location of file containing the template body. The URL must point to a * template that's located in an Amazon S3 bucket or a Systems Manager document. * For more information, go to Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline bool TemplateURLHasBeenSet() const { return m_templateURLHasBeenSet; } /** *

Location of file containing the template body. The URL must point to a * template that's located in an Amazon S3 bucket or a Systems Manager document. * For more information, go to Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline void SetTemplateURL(const Aws::String& value) { m_templateURLHasBeenSet = true; m_templateURL = value; } /** *

Location of file containing the template body. The URL must point to a * template that's located in an Amazon S3 bucket or a Systems Manager document. * For more information, go to Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline void SetTemplateURL(Aws::String&& value) { m_templateURLHasBeenSet = true; m_templateURL = std::move(value); } /** *

Location of file containing the template body. The URL must point to a * template that's located in an Amazon S3 bucket or a Systems Manager document. * For more information, go to Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline void SetTemplateURL(const char* value) { m_templateURLHasBeenSet = true; m_templateURL.assign(value); } /** *

Location of file containing the template body. The URL must point to a * template that's located in an Amazon S3 bucket or a Systems Manager document. * For more information, go to Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline UpdateStackRequest& WithTemplateURL(const Aws::String& value) { SetTemplateURL(value); return *this;} /** *

Location of file containing the template body. The URL must point to a * template that's located in an Amazon S3 bucket or a Systems Manager document. * For more information, go to Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline UpdateStackRequest& WithTemplateURL(Aws::String&& value) { SetTemplateURL(std::move(value)); return *this;} /** *

Location of file containing the template body. The URL must point to a * template that's located in an Amazon S3 bucket or a Systems Manager document. * For more information, go to Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify only one of the following parameters: TemplateBody, * TemplateURL, or set the UsePreviousTemplate to * true.

*/ inline UpdateStackRequest& WithTemplateURL(const char* value) { SetTemplateURL(value); return *this;} /** *

Reuse the existing template that is associated with the stack that you are * updating.

Conditional: You must specify only one of the following * parameters: TemplateBody, TemplateURL, or set the * UsePreviousTemplate to true.

*/ inline bool GetUsePreviousTemplate() const{ return m_usePreviousTemplate; } /** *

Reuse the existing template that is associated with the stack that you are * updating.

Conditional: You must specify only one of the following * parameters: TemplateBody, TemplateURL, or set the * UsePreviousTemplate to true.

*/ inline bool UsePreviousTemplateHasBeenSet() const { return m_usePreviousTemplateHasBeenSet; } /** *

Reuse the existing template that is associated with the stack that you are * updating.

Conditional: You must specify only one of the following * parameters: TemplateBody, TemplateURL, or set the * UsePreviousTemplate to true.

*/ inline void SetUsePreviousTemplate(bool value) { m_usePreviousTemplateHasBeenSet = true; m_usePreviousTemplate = value; } /** *

Reuse the existing template that is associated with the stack that you are * updating.

Conditional: You must specify only one of the following * parameters: TemplateBody, TemplateURL, or set the * UsePreviousTemplate to true.

*/ inline UpdateStackRequest& WithUsePreviousTemplate(bool value) { SetUsePreviousTemplate(value); return *this;} /** *

Structure containing the temporary overriding stack policy body. You can * specify either the StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline const Aws::String& GetStackPolicyDuringUpdateBody() const{ return m_stackPolicyDuringUpdateBody; } /** *

Structure containing the temporary overriding stack policy body. You can * specify either the StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline bool StackPolicyDuringUpdateBodyHasBeenSet() const { return m_stackPolicyDuringUpdateBodyHasBeenSet; } /** *

Structure containing the temporary overriding stack policy body. You can * specify either the StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline void SetStackPolicyDuringUpdateBody(const Aws::String& value) { m_stackPolicyDuringUpdateBodyHasBeenSet = true; m_stackPolicyDuringUpdateBody = value; } /** *

Structure containing the temporary overriding stack policy body. You can * specify either the StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline void SetStackPolicyDuringUpdateBody(Aws::String&& value) { m_stackPolicyDuringUpdateBodyHasBeenSet = true; m_stackPolicyDuringUpdateBody = std::move(value); } /** *

Structure containing the temporary overriding stack policy body. You can * specify either the StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline void SetStackPolicyDuringUpdateBody(const char* value) { m_stackPolicyDuringUpdateBodyHasBeenSet = true; m_stackPolicyDuringUpdateBody.assign(value); } /** *

Structure containing the temporary overriding stack policy body. You can * specify either the StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline UpdateStackRequest& WithStackPolicyDuringUpdateBody(const Aws::String& value) { SetStackPolicyDuringUpdateBody(value); return *this;} /** *

Structure containing the temporary overriding stack policy body. You can * specify either the StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline UpdateStackRequest& WithStackPolicyDuringUpdateBody(Aws::String&& value) { SetStackPolicyDuringUpdateBody(std::move(value)); return *this;} /** *

Structure containing the temporary overriding stack policy body. You can * specify either the StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline UpdateStackRequest& WithStackPolicyDuringUpdateBody(const char* value) { SetStackPolicyDuringUpdateBody(value); return *this;} /** *

Location of a file containing the temporary overriding stack policy. The URL * must point to a policy (max size: 16KB) located in an S3 bucket in the same * Region as the stack. You can specify either the * StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline const Aws::String& GetStackPolicyDuringUpdateURL() const{ return m_stackPolicyDuringUpdateURL; } /** *

Location of a file containing the temporary overriding stack policy. The URL * must point to a policy (max size: 16KB) located in an S3 bucket in the same * Region as the stack. You can specify either the * StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline bool StackPolicyDuringUpdateURLHasBeenSet() const { return m_stackPolicyDuringUpdateURLHasBeenSet; } /** *

Location of a file containing the temporary overriding stack policy. The URL * must point to a policy (max size: 16KB) located in an S3 bucket in the same * Region as the stack. You can specify either the * StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline void SetStackPolicyDuringUpdateURL(const Aws::String& value) { m_stackPolicyDuringUpdateURLHasBeenSet = true; m_stackPolicyDuringUpdateURL = value; } /** *

Location of a file containing the temporary overriding stack policy. The URL * must point to a policy (max size: 16KB) located in an S3 bucket in the same * Region as the stack. You can specify either the * StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline void SetStackPolicyDuringUpdateURL(Aws::String&& value) { m_stackPolicyDuringUpdateURLHasBeenSet = true; m_stackPolicyDuringUpdateURL = std::move(value); } /** *

Location of a file containing the temporary overriding stack policy. The URL * must point to a policy (max size: 16KB) located in an S3 bucket in the same * Region as the stack. You can specify either the * StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline void SetStackPolicyDuringUpdateURL(const char* value) { m_stackPolicyDuringUpdateURLHasBeenSet = true; m_stackPolicyDuringUpdateURL.assign(value); } /** *

Location of a file containing the temporary overriding stack policy. The URL * must point to a policy (max size: 16KB) located in an S3 bucket in the same * Region as the stack. You can specify either the * StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline UpdateStackRequest& WithStackPolicyDuringUpdateURL(const Aws::String& value) { SetStackPolicyDuringUpdateURL(value); return *this;} /** *

Location of a file containing the temporary overriding stack policy. The URL * must point to a policy (max size: 16KB) located in an S3 bucket in the same * Region as the stack. You can specify either the * StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline UpdateStackRequest& WithStackPolicyDuringUpdateURL(Aws::String&& value) { SetStackPolicyDuringUpdateURL(std::move(value)); return *this;} /** *

Location of a file containing the temporary overriding stack policy. The URL * must point to a policy (max size: 16KB) located in an S3 bucket in the same * Region as the stack. You can specify either the * StackPolicyDuringUpdateBody or the * StackPolicyDuringUpdateURL parameter, but not both.

If you * want to update protected resources, specify a temporary overriding stack policy * during this update. If you don't specify a stack policy, the current policy that * is associated with the stack will be used.

*/ inline UpdateStackRequest& WithStackPolicyDuringUpdateURL(const char* value) { SetStackPolicyDuringUpdateURL(value); return *this;} /** *

A list of Parameter structures that specify input parameters for * the stack. For more information, see the Parameter * data type.

*/ inline const Aws::Vector& GetParameters() const{ return m_parameters; } /** *

A list of Parameter structures that specify input parameters for * the stack. For more information, see the Parameter * data type.

*/ inline bool ParametersHasBeenSet() const { return m_parametersHasBeenSet; } /** *

A list of Parameter structures that specify input parameters for * the stack. For more information, see the Parameter * data type.

*/ inline void SetParameters(const Aws::Vector& value) { m_parametersHasBeenSet = true; m_parameters = value; } /** *

A list of Parameter structures that specify input parameters for * the stack. For more information, see the Parameter * data type.

*/ inline void SetParameters(Aws::Vector&& value) { m_parametersHasBeenSet = true; m_parameters = std::move(value); } /** *

A list of Parameter structures that specify input parameters for * the stack. For more information, see the Parameter * data type.

*/ inline UpdateStackRequest& WithParameters(const Aws::Vector& value) { SetParameters(value); return *this;} /** *

A list of Parameter structures that specify input parameters for * the stack. For more information, see the Parameter * data type.

*/ inline UpdateStackRequest& WithParameters(Aws::Vector&& value) { SetParameters(std::move(value)); return *this;} /** *

A list of Parameter structures that specify input parameters for * the stack. For more information, see the Parameter * data type.

*/ inline UpdateStackRequest& AddParameters(const Parameter& value) { m_parametersHasBeenSet = true; m_parameters.push_back(value); return *this; } /** *

A list of Parameter structures that specify input parameters for * the stack. For more information, see the Parameter * data type.

*/ inline UpdateStackRequest& AddParameters(Parameter&& value) { m_parametersHasBeenSet = true; m_parameters.push_back(std::move(value)); return *this; } /** *

In some cases, you must explicitly acknowledge that your stack template * contains certain capabilities in order for CloudFormation to update the * stack.

  • CAPABILITY_IAM and * CAPABILITY_NAMED_IAM

    Some stack templates might include * resources that can affect permissions in your Amazon Web Services account; for * example, by creating new Identity and Access Management (IAM) users. For those * stacks, you must explicitly acknowledge this by specifying one of these * capabilities.

    The following IAM resources require you to specify either * the CAPABILITY_IAM or CAPABILITY_NAMED_IAM * capability.

    • If you have IAM resources, you can specify either * capability.

    • If you have IAM resources with custom names, you * must specify CAPABILITY_NAMED_IAM.

    • If you * don't specify either of these capabilities, CloudFormation returns an * InsufficientCapabilities error.

    If your stack * template contains these resources, we suggest that you review all permissions * associated with them and edit their permissions if necessary.

    For more information, see Acknowledging * IAM Resources in CloudFormation Templates.

  • * CAPABILITY_AUTO_EXPAND

    Some template contain macros. Macros * perform custom processing on templates; this can include simple actions like * find-and-replace operations, all the way to extensive transformations of entire * templates. Because of this, users typically create a change set from the * processed template, so that they can review the changes resulting from the * macros before actually updating the stack. If your stack template contains one * or more macros, and you choose to update a stack directly from the processed * template, without first reviewing the resulting changes in a change set, you * must acknowledge this capability. This includes the AWS::Include * and AWS::Serverless * transforms, which are macros hosted by CloudFormation.

    If you want to * update a stack from a stack template that contains macros and nested * stacks, you must update the stack directly from the template using this * capability.

    You should only update stacks directly from a * stack template that contains macros if you know what processing the macro * performs.

    Each macro relies on an underlying Lambda service function for * processing stack templates. Be aware that the Lambda function owner can update * the function operation without CloudFormation being notified.

    *

    For more information, see Using * CloudFormation Macros to Perform Custom Processing on Templates.

  • *
*/ inline const Aws::Vector& GetCapabilities() const{ return m_capabilities; } /** *

In some cases, you must explicitly acknowledge that your stack template * contains certain capabilities in order for CloudFormation to update the * stack.

  • CAPABILITY_IAM and * CAPABILITY_NAMED_IAM

    Some stack templates might include * resources that can affect permissions in your Amazon Web Services account; for * example, by creating new Identity and Access Management (IAM) users. For those * stacks, you must explicitly acknowledge this by specifying one of these * capabilities.

    The following IAM resources require you to specify either * the CAPABILITY_IAM or CAPABILITY_NAMED_IAM * capability.

    • If you have IAM resources, you can specify either * capability.

    • If you have IAM resources with custom names, you * must specify CAPABILITY_NAMED_IAM.

    • If you * don't specify either of these capabilities, CloudFormation returns an * InsufficientCapabilities error.

    If your stack * template contains these resources, we suggest that you review all permissions * associated with them and edit their permissions if necessary.

    For more information, see Acknowledging * IAM Resources in CloudFormation Templates.

  • * CAPABILITY_AUTO_EXPAND

    Some template contain macros. Macros * perform custom processing on templates; this can include simple actions like * find-and-replace operations, all the way to extensive transformations of entire * templates. Because of this, users typically create a change set from the * processed template, so that they can review the changes resulting from the * macros before actually updating the stack. If your stack template contains one * or more macros, and you choose to update a stack directly from the processed * template, without first reviewing the resulting changes in a change set, you * must acknowledge this capability. This includes the AWS::Include * and AWS::Serverless * transforms, which are macros hosted by CloudFormation.

    If you want to * update a stack from a stack template that contains macros and nested * stacks, you must update the stack directly from the template using this * capability.

    You should only update stacks directly from a * stack template that contains macros if you know what processing the macro * performs.

    Each macro relies on an underlying Lambda service function for * processing stack templates. Be aware that the Lambda function owner can update * the function operation without CloudFormation being notified.

    *

    For more information, see Using * CloudFormation Macros to Perform Custom Processing on Templates.

  • *
*/ inline bool CapabilitiesHasBeenSet() const { return m_capabilitiesHasBeenSet; } /** *

In some cases, you must explicitly acknowledge that your stack template * contains certain capabilities in order for CloudFormation to update the * stack.

  • CAPABILITY_IAM and * CAPABILITY_NAMED_IAM

    Some stack templates might include * resources that can affect permissions in your Amazon Web Services account; for * example, by creating new Identity and Access Management (IAM) users. For those * stacks, you must explicitly acknowledge this by specifying one of these * capabilities.

    The following IAM resources require you to specify either * the CAPABILITY_IAM or CAPABILITY_NAMED_IAM * capability.

    • If you have IAM resources, you can specify either * capability.

    • If you have IAM resources with custom names, you * must specify CAPABILITY_NAMED_IAM.

    • If you * don't specify either of these capabilities, CloudFormation returns an * InsufficientCapabilities error.

    If your stack * template contains these resources, we suggest that you review all permissions * associated with them and edit their permissions if necessary.

    For more information, see Acknowledging * IAM Resources in CloudFormation Templates.

  • * CAPABILITY_AUTO_EXPAND

    Some template contain macros. Macros * perform custom processing on templates; this can include simple actions like * find-and-replace operations, all the way to extensive transformations of entire * templates. Because of this, users typically create a change set from the * processed template, so that they can review the changes resulting from the * macros before actually updating the stack. If your stack template contains one * or more macros, and you choose to update a stack directly from the processed * template, without first reviewing the resulting changes in a change set, you * must acknowledge this capability. This includes the AWS::Include * and AWS::Serverless * transforms, which are macros hosted by CloudFormation.

    If you want to * update a stack from a stack template that contains macros and nested * stacks, you must update the stack directly from the template using this * capability.

    You should only update stacks directly from a * stack template that contains macros if you know what processing the macro * performs.

    Each macro relies on an underlying Lambda service function for * processing stack templates. Be aware that the Lambda function owner can update * the function operation without CloudFormation being notified.

    *

    For more information, see Using * CloudFormation Macros to Perform Custom Processing on Templates.

  • *
*/ inline void SetCapabilities(const Aws::Vector& value) { m_capabilitiesHasBeenSet = true; m_capabilities = value; } /** *

In some cases, you must explicitly acknowledge that your stack template * contains certain capabilities in order for CloudFormation to update the * stack.

  • CAPABILITY_IAM and * CAPABILITY_NAMED_IAM

    Some stack templates might include * resources that can affect permissions in your Amazon Web Services account; for * example, by creating new Identity and Access Management (IAM) users. For those * stacks, you must explicitly acknowledge this by specifying one of these * capabilities.

    The following IAM resources require you to specify either * the CAPABILITY_IAM or CAPABILITY_NAMED_IAM * capability.

    • If you have IAM resources, you can specify either * capability.

    • If you have IAM resources with custom names, you * must specify CAPABILITY_NAMED_IAM.

    • If you * don't specify either of these capabilities, CloudFormation returns an * InsufficientCapabilities error.

    If your stack * template contains these resources, we suggest that you review all permissions * associated with them and edit their permissions if necessary.

    For more information, see Acknowledging * IAM Resources in CloudFormation Templates.

  • * CAPABILITY_AUTO_EXPAND

    Some template contain macros. Macros * perform custom processing on templates; this can include simple actions like * find-and-replace operations, all the way to extensive transformations of entire * templates. Because of this, users typically create a change set from the * processed template, so that they can review the changes resulting from the * macros before actually updating the stack. If your stack template contains one * or more macros, and you choose to update a stack directly from the processed * template, without first reviewing the resulting changes in a change set, you * must acknowledge this capability. This includes the AWS::Include * and AWS::Serverless * transforms, which are macros hosted by CloudFormation.

    If you want to * update a stack from a stack template that contains macros and nested * stacks, you must update the stack directly from the template using this * capability.

    You should only update stacks directly from a * stack template that contains macros if you know what processing the macro * performs.

    Each macro relies on an underlying Lambda service function for * processing stack templates. Be aware that the Lambda function owner can update * the function operation without CloudFormation being notified.

    *

    For more information, see Using * CloudFormation Macros to Perform Custom Processing on Templates.

  • *
*/ inline void SetCapabilities(Aws::Vector&& value) { m_capabilitiesHasBeenSet = true; m_capabilities = std::move(value); } /** *

In some cases, you must explicitly acknowledge that your stack template * contains certain capabilities in order for CloudFormation to update the * stack.

  • CAPABILITY_IAM and * CAPABILITY_NAMED_IAM

    Some stack templates might include * resources that can affect permissions in your Amazon Web Services account; for * example, by creating new Identity and Access Management (IAM) users. For those * stacks, you must explicitly acknowledge this by specifying one of these * capabilities.

    The following IAM resources require you to specify either * the CAPABILITY_IAM or CAPABILITY_NAMED_IAM * capability.

    • If you have IAM resources, you can specify either * capability.

    • If you have IAM resources with custom names, you * must specify CAPABILITY_NAMED_IAM.

    • If you * don't specify either of these capabilities, CloudFormation returns an * InsufficientCapabilities error.

    If your stack * template contains these resources, we suggest that you review all permissions * associated with them and edit their permissions if necessary.

    For more information, see Acknowledging * IAM Resources in CloudFormation Templates.

  • * CAPABILITY_AUTO_EXPAND

    Some template contain macros. Macros * perform custom processing on templates; this can include simple actions like * find-and-replace operations, all the way to extensive transformations of entire * templates. Because of this, users typically create a change set from the * processed template, so that they can review the changes resulting from the * macros before actually updating the stack. If your stack template contains one * or more macros, and you choose to update a stack directly from the processed * template, without first reviewing the resulting changes in a change set, you * must acknowledge this capability. This includes the AWS::Include * and AWS::Serverless * transforms, which are macros hosted by CloudFormation.

    If you want to * update a stack from a stack template that contains macros and nested * stacks, you must update the stack directly from the template using this * capability.

    You should only update stacks directly from a * stack template that contains macros if you know what processing the macro * performs.

    Each macro relies on an underlying Lambda service function for * processing stack templates. Be aware that the Lambda function owner can update * the function operation without CloudFormation being notified.

    *

    For more information, see Using * CloudFormation Macros to Perform Custom Processing on Templates.

  • *
*/ inline UpdateStackRequest& WithCapabilities(const Aws::Vector& value) { SetCapabilities(value); return *this;} /** *

In some cases, you must explicitly acknowledge that your stack template * contains certain capabilities in order for CloudFormation to update the * stack.

  • CAPABILITY_IAM and * CAPABILITY_NAMED_IAM

    Some stack templates might include * resources that can affect permissions in your Amazon Web Services account; for * example, by creating new Identity and Access Management (IAM) users. For those * stacks, you must explicitly acknowledge this by specifying one of these * capabilities.

    The following IAM resources require you to specify either * the CAPABILITY_IAM or CAPABILITY_NAMED_IAM * capability.

    • If you have IAM resources, you can specify either * capability.

    • If you have IAM resources with custom names, you * must specify CAPABILITY_NAMED_IAM.

    • If you * don't specify either of these capabilities, CloudFormation returns an * InsufficientCapabilities error.

    If your stack * template contains these resources, we suggest that you review all permissions * associated with them and edit their permissions if necessary.

    For more information, see Acknowledging * IAM Resources in CloudFormation Templates.

  • * CAPABILITY_AUTO_EXPAND

    Some template contain macros. Macros * perform custom processing on templates; this can include simple actions like * find-and-replace operations, all the way to extensive transformations of entire * templates. Because of this, users typically create a change set from the * processed template, so that they can review the changes resulting from the * macros before actually updating the stack. If your stack template contains one * or more macros, and you choose to update a stack directly from the processed * template, without first reviewing the resulting changes in a change set, you * must acknowledge this capability. This includes the AWS::Include * and AWS::Serverless * transforms, which are macros hosted by CloudFormation.

    If you want to * update a stack from a stack template that contains macros and nested * stacks, you must update the stack directly from the template using this * capability.

    You should only update stacks directly from a * stack template that contains macros if you know what processing the macro * performs.

    Each macro relies on an underlying Lambda service function for * processing stack templates. Be aware that the Lambda function owner can update * the function operation without CloudFormation being notified.

    *

    For more information, see Using * CloudFormation Macros to Perform Custom Processing on Templates.

  • *
*/ inline UpdateStackRequest& WithCapabilities(Aws::Vector&& value) { SetCapabilities(std::move(value)); return *this;} /** *

In some cases, you must explicitly acknowledge that your stack template * contains certain capabilities in order for CloudFormation to update the * stack.

  • CAPABILITY_IAM and * CAPABILITY_NAMED_IAM

    Some stack templates might include * resources that can affect permissions in your Amazon Web Services account; for * example, by creating new Identity and Access Management (IAM) users. For those * stacks, you must explicitly acknowledge this by specifying one of these * capabilities.

    The following IAM resources require you to specify either * the CAPABILITY_IAM or CAPABILITY_NAMED_IAM * capability.

    • If you have IAM resources, you can specify either * capability.

    • If you have IAM resources with custom names, you * must specify CAPABILITY_NAMED_IAM.

    • If you * don't specify either of these capabilities, CloudFormation returns an * InsufficientCapabilities error.

    If your stack * template contains these resources, we suggest that you review all permissions * associated with them and edit their permissions if necessary.

    For more information, see Acknowledging * IAM Resources in CloudFormation Templates.

  • * CAPABILITY_AUTO_EXPAND

    Some template contain macros. Macros * perform custom processing on templates; this can include simple actions like * find-and-replace operations, all the way to extensive transformations of entire * templates. Because of this, users typically create a change set from the * processed template, so that they can review the changes resulting from the * macros before actually updating the stack. If your stack template contains one * or more macros, and you choose to update a stack directly from the processed * template, without first reviewing the resulting changes in a change set, you * must acknowledge this capability. This includes the AWS::Include * and AWS::Serverless * transforms, which are macros hosted by CloudFormation.

    If you want to * update a stack from a stack template that contains macros and nested * stacks, you must update the stack directly from the template using this * capability.

    You should only update stacks directly from a * stack template that contains macros if you know what processing the macro * performs.

    Each macro relies on an underlying Lambda service function for * processing stack templates. Be aware that the Lambda function owner can update * the function operation without CloudFormation being notified.

    *

    For more information, see Using * CloudFormation Macros to Perform Custom Processing on Templates.

  • *
*/ inline UpdateStackRequest& AddCapabilities(const Capability& value) { m_capabilitiesHasBeenSet = true; m_capabilities.push_back(value); return *this; } /** *

In some cases, you must explicitly acknowledge that your stack template * contains certain capabilities in order for CloudFormation to update the * stack.

  • CAPABILITY_IAM and * CAPABILITY_NAMED_IAM

    Some stack templates might include * resources that can affect permissions in your Amazon Web Services account; for * example, by creating new Identity and Access Management (IAM) users. For those * stacks, you must explicitly acknowledge this by specifying one of these * capabilities.

    The following IAM resources require you to specify either * the CAPABILITY_IAM or CAPABILITY_NAMED_IAM * capability.

    • If you have IAM resources, you can specify either * capability.

    • If you have IAM resources with custom names, you * must specify CAPABILITY_NAMED_IAM.

    • If you * don't specify either of these capabilities, CloudFormation returns an * InsufficientCapabilities error.

    If your stack * template contains these resources, we suggest that you review all permissions * associated with them and edit their permissions if necessary.

    For more information, see Acknowledging * IAM Resources in CloudFormation Templates.

  • * CAPABILITY_AUTO_EXPAND

    Some template contain macros. Macros * perform custom processing on templates; this can include simple actions like * find-and-replace operations, all the way to extensive transformations of entire * templates. Because of this, users typically create a change set from the * processed template, so that they can review the changes resulting from the * macros before actually updating the stack. If your stack template contains one * or more macros, and you choose to update a stack directly from the processed * template, without first reviewing the resulting changes in a change set, you * must acknowledge this capability. This includes the AWS::Include * and AWS::Serverless * transforms, which are macros hosted by CloudFormation.

    If you want to * update a stack from a stack template that contains macros and nested * stacks, you must update the stack directly from the template using this * capability.

    You should only update stacks directly from a * stack template that contains macros if you know what processing the macro * performs.

    Each macro relies on an underlying Lambda service function for * processing stack templates. Be aware that the Lambda function owner can update * the function operation without CloudFormation being notified.

    *

    For more information, see Using * CloudFormation Macros to Perform Custom Processing on Templates.

  • *
*/ inline UpdateStackRequest& AddCapabilities(Capability&& value) { m_capabilitiesHasBeenSet = true; m_capabilities.push_back(std::move(value)); return *this; } /** *

The template resource types that you have permissions to work with for this * update stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance.

If * the list of resource types doesn't include a resource that you're updating, the * stack update fails. By default, CloudFormation grants permissions to all * resource types. Identity and Access Management (IAM) uses this parameter for * CloudFormation-specific condition keys in IAM policies. For more information, * see Controlling * Access with Identity and Access Management.

*/ inline const Aws::Vector& GetResourceTypes() const{ return m_resourceTypes; } /** *

The template resource types that you have permissions to work with for this * update stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance.

If * the list of resource types doesn't include a resource that you're updating, the * stack update fails. By default, CloudFormation grants permissions to all * resource types. Identity and Access Management (IAM) uses this parameter for * CloudFormation-specific condition keys in IAM policies. For more information, * see Controlling * Access with Identity and Access Management.

*/ inline bool ResourceTypesHasBeenSet() const { return m_resourceTypesHasBeenSet; } /** *

The template resource types that you have permissions to work with for this * update stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance.

If * the list of resource types doesn't include a resource that you're updating, the * stack update fails. By default, CloudFormation grants permissions to all * resource types. Identity and Access Management (IAM) uses this parameter for * CloudFormation-specific condition keys in IAM policies. For more information, * see Controlling * Access with Identity and Access Management.

*/ inline void SetResourceTypes(const Aws::Vector& value) { m_resourceTypesHasBeenSet = true; m_resourceTypes = value; } /** *

The template resource types that you have permissions to work with for this * update stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance.

If * the list of resource types doesn't include a resource that you're updating, the * stack update fails. By default, CloudFormation grants permissions to all * resource types. Identity and Access Management (IAM) uses this parameter for * CloudFormation-specific condition keys in IAM policies. For more information, * see Controlling * Access with Identity and Access Management.

*/ inline void SetResourceTypes(Aws::Vector&& value) { m_resourceTypesHasBeenSet = true; m_resourceTypes = std::move(value); } /** *

The template resource types that you have permissions to work with for this * update stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance.

If * the list of resource types doesn't include a resource that you're updating, the * stack update fails. By default, CloudFormation grants permissions to all * resource types. Identity and Access Management (IAM) uses this parameter for * CloudFormation-specific condition keys in IAM policies. For more information, * see Controlling * Access with Identity and Access Management.

*/ inline UpdateStackRequest& WithResourceTypes(const Aws::Vector& value) { SetResourceTypes(value); return *this;} /** *

The template resource types that you have permissions to work with for this * update stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance.

If * the list of resource types doesn't include a resource that you're updating, the * stack update fails. By default, CloudFormation grants permissions to all * resource types. Identity and Access Management (IAM) uses this parameter for * CloudFormation-specific condition keys in IAM policies. For more information, * see Controlling * Access with Identity and Access Management.

*/ inline UpdateStackRequest& WithResourceTypes(Aws::Vector&& value) { SetResourceTypes(std::move(value)); return *this;} /** *

The template resource types that you have permissions to work with for this * update stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance.

If * the list of resource types doesn't include a resource that you're updating, the * stack update fails. By default, CloudFormation grants permissions to all * resource types. Identity and Access Management (IAM) uses this parameter for * CloudFormation-specific condition keys in IAM policies. For more information, * see Controlling * Access with Identity and Access Management.

*/ inline UpdateStackRequest& AddResourceTypes(const Aws::String& value) { m_resourceTypesHasBeenSet = true; m_resourceTypes.push_back(value); return *this; } /** *

The template resource types that you have permissions to work with for this * update stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance.

If * the list of resource types doesn't include a resource that you're updating, the * stack update fails. By default, CloudFormation grants permissions to all * resource types. Identity and Access Management (IAM) uses this parameter for * CloudFormation-specific condition keys in IAM policies. For more information, * see Controlling * Access with Identity and Access Management.

*/ inline UpdateStackRequest& AddResourceTypes(Aws::String&& value) { m_resourceTypesHasBeenSet = true; m_resourceTypes.push_back(std::move(value)); return *this; } /** *

The template resource types that you have permissions to work with for this * update stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance.

If * the list of resource types doesn't include a resource that you're updating, the * stack update fails. By default, CloudFormation grants permissions to all * resource types. Identity and Access Management (IAM) uses this parameter for * CloudFormation-specific condition keys in IAM policies. For more information, * see Controlling * Access with Identity and Access Management.

*/ inline UpdateStackRequest& AddResourceTypes(const char* value) { m_resourceTypesHasBeenSet = true; m_resourceTypes.push_back(value); return *this; } /** *

The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) * role that CloudFormation assumes to update the stack. CloudFormation uses the * role's credentials to make calls on your behalf. CloudFormation always uses this * role for all future operations on the stack. Provided that users have permission * to operate on the stack, CloudFormation uses this role even if the users don't * have permission to pass it. Ensure that the role grants least privilege.

*

If you don't specify a value, CloudFormation uses the role that was * previously associated with the stack. If no role is available, CloudFormation * uses a temporary session that is generated from your user credentials.

*/ inline const Aws::String& GetRoleARN() const{ return m_roleARN; } /** *

The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) * role that CloudFormation assumes to update the stack. CloudFormation uses the * role's credentials to make calls on your behalf. CloudFormation always uses this * role for all future operations on the stack. Provided that users have permission * to operate on the stack, CloudFormation uses this role even if the users don't * have permission to pass it. Ensure that the role grants least privilege.

*

If you don't specify a value, CloudFormation uses the role that was * previously associated with the stack. If no role is available, CloudFormation * uses a temporary session that is generated from your user credentials.

*/ inline bool RoleARNHasBeenSet() const { return m_roleARNHasBeenSet; } /** *

The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) * role that CloudFormation assumes to update the stack. CloudFormation uses the * role's credentials to make calls on your behalf. CloudFormation always uses this * role for all future operations on the stack. Provided that users have permission * to operate on the stack, CloudFormation uses this role even if the users don't * have permission to pass it. Ensure that the role grants least privilege.

*

If you don't specify a value, CloudFormation uses the role that was * previously associated with the stack. If no role is available, CloudFormation * uses a temporary session that is generated from your user credentials.

*/ inline void SetRoleARN(const Aws::String& value) { m_roleARNHasBeenSet = true; m_roleARN = value; } /** *

The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) * role that CloudFormation assumes to update the stack. CloudFormation uses the * role's credentials to make calls on your behalf. CloudFormation always uses this * role for all future operations on the stack. Provided that users have permission * to operate on the stack, CloudFormation uses this role even if the users don't * have permission to pass it. Ensure that the role grants least privilege.

*

If you don't specify a value, CloudFormation uses the role that was * previously associated with the stack. If no role is available, CloudFormation * uses a temporary session that is generated from your user credentials.

*/ inline void SetRoleARN(Aws::String&& value) { m_roleARNHasBeenSet = true; m_roleARN = std::move(value); } /** *

The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) * role that CloudFormation assumes to update the stack. CloudFormation uses the * role's credentials to make calls on your behalf. CloudFormation always uses this * role for all future operations on the stack. Provided that users have permission * to operate on the stack, CloudFormation uses this role even if the users don't * have permission to pass it. Ensure that the role grants least privilege.

*

If you don't specify a value, CloudFormation uses the role that was * previously associated with the stack. If no role is available, CloudFormation * uses a temporary session that is generated from your user credentials.

*/ inline void SetRoleARN(const char* value) { m_roleARNHasBeenSet = true; m_roleARN.assign(value); } /** *

The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) * role that CloudFormation assumes to update the stack. CloudFormation uses the * role's credentials to make calls on your behalf. CloudFormation always uses this * role for all future operations on the stack. Provided that users have permission * to operate on the stack, CloudFormation uses this role even if the users don't * have permission to pass it. Ensure that the role grants least privilege.

*

If you don't specify a value, CloudFormation uses the role that was * previously associated with the stack. If no role is available, CloudFormation * uses a temporary session that is generated from your user credentials.

*/ inline UpdateStackRequest& WithRoleARN(const Aws::String& value) { SetRoleARN(value); return *this;} /** *

The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) * role that CloudFormation assumes to update the stack. CloudFormation uses the * role's credentials to make calls on your behalf. CloudFormation always uses this * role for all future operations on the stack. Provided that users have permission * to operate on the stack, CloudFormation uses this role even if the users don't * have permission to pass it. Ensure that the role grants least privilege.

*

If you don't specify a value, CloudFormation uses the role that was * previously associated with the stack. If no role is available, CloudFormation * uses a temporary session that is generated from your user credentials.

*/ inline UpdateStackRequest& WithRoleARN(Aws::String&& value) { SetRoleARN(std::move(value)); return *this;} /** *

The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) * role that CloudFormation assumes to update the stack. CloudFormation uses the * role's credentials to make calls on your behalf. CloudFormation always uses this * role for all future operations on the stack. Provided that users have permission * to operate on the stack, CloudFormation uses this role even if the users don't * have permission to pass it. Ensure that the role grants least privilege.

*

If you don't specify a value, CloudFormation uses the role that was * previously associated with the stack. If no role is available, CloudFormation * uses a temporary session that is generated from your user credentials.

*/ inline UpdateStackRequest& WithRoleARN(const char* value) { SetRoleARN(value); return *this;} /** *

The rollback triggers for CloudFormation to monitor during stack creation and * updating operations, and for the specified monitoring period afterwards.

*/ inline const RollbackConfiguration& GetRollbackConfiguration() const{ return m_rollbackConfiguration; } /** *

The rollback triggers for CloudFormation to monitor during stack creation and * updating operations, and for the specified monitoring period afterwards.

*/ inline bool RollbackConfigurationHasBeenSet() const { return m_rollbackConfigurationHasBeenSet; } /** *

The rollback triggers for CloudFormation to monitor during stack creation and * updating operations, and for the specified monitoring period afterwards.

*/ inline void SetRollbackConfiguration(const RollbackConfiguration& value) { m_rollbackConfigurationHasBeenSet = true; m_rollbackConfiguration = value; } /** *

The rollback triggers for CloudFormation to monitor during stack creation and * updating operations, and for the specified monitoring period afterwards.

*/ inline void SetRollbackConfiguration(RollbackConfiguration&& value) { m_rollbackConfigurationHasBeenSet = true; m_rollbackConfiguration = std::move(value); } /** *

The rollback triggers for CloudFormation to monitor during stack creation and * updating operations, and for the specified monitoring period afterwards.

*/ inline UpdateStackRequest& WithRollbackConfiguration(const RollbackConfiguration& value) { SetRollbackConfiguration(value); return *this;} /** *

The rollback triggers for CloudFormation to monitor during stack creation and * updating operations, and for the specified monitoring period afterwards.

*/ inline UpdateStackRequest& WithRollbackConfiguration(RollbackConfiguration&& value) { SetRollbackConfiguration(std::move(value)); return *this;} /** *

Structure containing a new stack policy body. You can specify either the * StackPolicyBody or the StackPolicyURL parameter, but * not both.

You might update the stack policy, for example, in order to * protect a new resource that you created during a stack update. If you don't * specify a stack policy, the current policy that is associated with the stack is * unchanged.

*/ inline const Aws::String& GetStackPolicyBody() const{ return m_stackPolicyBody; } /** *

Structure containing a new stack policy body. You can specify either the * StackPolicyBody or the StackPolicyURL parameter, but * not both.

You might update the stack policy, for example, in order to * protect a new resource that you created during a stack update. If you don't * specify a stack policy, the current policy that is associated with the stack is * unchanged.

*/ inline bool StackPolicyBodyHasBeenSet() const { return m_stackPolicyBodyHasBeenSet; } /** *

Structure containing a new stack policy body. You can specify either the * StackPolicyBody or the StackPolicyURL parameter, but * not both.

You might update the stack policy, for example, in order to * protect a new resource that you created during a stack update. If you don't * specify a stack policy, the current policy that is associated with the stack is * unchanged.

*/ inline void SetStackPolicyBody(const Aws::String& value) { m_stackPolicyBodyHasBeenSet = true; m_stackPolicyBody = value; } /** *

Structure containing a new stack policy body. You can specify either the * StackPolicyBody or the StackPolicyURL parameter, but * not both.

You might update the stack policy, for example, in order to * protect a new resource that you created during a stack update. If you don't * specify a stack policy, the current policy that is associated with the stack is * unchanged.

*/ inline void SetStackPolicyBody(Aws::String&& value) { m_stackPolicyBodyHasBeenSet = true; m_stackPolicyBody = std::move(value); } /** *

Structure containing a new stack policy body. You can specify either the * StackPolicyBody or the StackPolicyURL parameter, but * not both.

You might update the stack policy, for example, in order to * protect a new resource that you created during a stack update. If you don't * specify a stack policy, the current policy that is associated with the stack is * unchanged.

*/ inline void SetStackPolicyBody(const char* value) { m_stackPolicyBodyHasBeenSet = true; m_stackPolicyBody.assign(value); } /** *

Structure containing a new stack policy body. You can specify either the * StackPolicyBody or the StackPolicyURL parameter, but * not both.

You might update the stack policy, for example, in order to * protect a new resource that you created during a stack update. If you don't * specify a stack policy, the current policy that is associated with the stack is * unchanged.

*/ inline UpdateStackRequest& WithStackPolicyBody(const Aws::String& value) { SetStackPolicyBody(value); return *this;} /** *

Structure containing a new stack policy body. You can specify either the * StackPolicyBody or the StackPolicyURL parameter, but * not both.

You might update the stack policy, for example, in order to * protect a new resource that you created during a stack update. If you don't * specify a stack policy, the current policy that is associated with the stack is * unchanged.

*/ inline UpdateStackRequest& WithStackPolicyBody(Aws::String&& value) { SetStackPolicyBody(std::move(value)); return *this;} /** *

Structure containing a new stack policy body. You can specify either the * StackPolicyBody or the StackPolicyURL parameter, but * not both.

You might update the stack policy, for example, in order to * protect a new resource that you created during a stack update. If you don't * specify a stack policy, the current policy that is associated with the stack is * unchanged.

*/ inline UpdateStackRequest& WithStackPolicyBody(const char* value) { SetStackPolicyBody(value); return *this;} /** *

Location of a file containing the updated stack policy. The URL must point to * a policy (max size: 16KB) located in an S3 bucket in the same Region as the * stack. You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

You might update the * stack policy, for example, in order to protect a new resource that you created * during a stack update. If you don't specify a stack policy, the current policy * that is associated with the stack is unchanged.

*/ inline const Aws::String& GetStackPolicyURL() const{ return m_stackPolicyURL; } /** *

Location of a file containing the updated stack policy. The URL must point to * a policy (max size: 16KB) located in an S3 bucket in the same Region as the * stack. You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

You might update the * stack policy, for example, in order to protect a new resource that you created * during a stack update. If you don't specify a stack policy, the current policy * that is associated with the stack is unchanged.

*/ inline bool StackPolicyURLHasBeenSet() const { return m_stackPolicyURLHasBeenSet; } /** *

Location of a file containing the updated stack policy. The URL must point to * a policy (max size: 16KB) located in an S3 bucket in the same Region as the * stack. You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

You might update the * stack policy, for example, in order to protect a new resource that you created * during a stack update. If you don't specify a stack policy, the current policy * that is associated with the stack is unchanged.

*/ inline void SetStackPolicyURL(const Aws::String& value) { m_stackPolicyURLHasBeenSet = true; m_stackPolicyURL = value; } /** *

Location of a file containing the updated stack policy. The URL must point to * a policy (max size: 16KB) located in an S3 bucket in the same Region as the * stack. You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

You might update the * stack policy, for example, in order to protect a new resource that you created * during a stack update. If you don't specify a stack policy, the current policy * that is associated with the stack is unchanged.

*/ inline void SetStackPolicyURL(Aws::String&& value) { m_stackPolicyURLHasBeenSet = true; m_stackPolicyURL = std::move(value); } /** *

Location of a file containing the updated stack policy. The URL must point to * a policy (max size: 16KB) located in an S3 bucket in the same Region as the * stack. You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

You might update the * stack policy, for example, in order to protect a new resource that you created * during a stack update. If you don't specify a stack policy, the current policy * that is associated with the stack is unchanged.

*/ inline void SetStackPolicyURL(const char* value) { m_stackPolicyURLHasBeenSet = true; m_stackPolicyURL.assign(value); } /** *

Location of a file containing the updated stack policy. The URL must point to * a policy (max size: 16KB) located in an S3 bucket in the same Region as the * stack. You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

You might update the * stack policy, for example, in order to protect a new resource that you created * during a stack update. If you don't specify a stack policy, the current policy * that is associated with the stack is unchanged.

*/ inline UpdateStackRequest& WithStackPolicyURL(const Aws::String& value) { SetStackPolicyURL(value); return *this;} /** *

Location of a file containing the updated stack policy. The URL must point to * a policy (max size: 16KB) located in an S3 bucket in the same Region as the * stack. You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

You might update the * stack policy, for example, in order to protect a new resource that you created * during a stack update. If you don't specify a stack policy, the current policy * that is associated with the stack is unchanged.

*/ inline UpdateStackRequest& WithStackPolicyURL(Aws::String&& value) { SetStackPolicyURL(std::move(value)); return *this;} /** *

Location of a file containing the updated stack policy. The URL must point to * a policy (max size: 16KB) located in an S3 bucket in the same Region as the * stack. You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

You might update the * stack policy, for example, in order to protect a new resource that you created * during a stack update. If you don't specify a stack policy, the current policy * that is associated with the stack is unchanged.

*/ inline UpdateStackRequest& WithStackPolicyURL(const char* value) { SetStackPolicyURL(value); return *this;} /** *

Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that * CloudFormation associates with the stack. Specify an empty list to remove all * notification topics.

*/ inline const Aws::Vector& GetNotificationARNs() const{ return m_notificationARNs; } /** *

Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that * CloudFormation associates with the stack. Specify an empty list to remove all * notification topics.

*/ inline bool NotificationARNsHasBeenSet() const { return m_notificationARNsHasBeenSet; } /** *

Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that * CloudFormation associates with the stack. Specify an empty list to remove all * notification topics.

*/ inline void SetNotificationARNs(const Aws::Vector& value) { m_notificationARNsHasBeenSet = true; m_notificationARNs = value; } /** *

Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that * CloudFormation associates with the stack. Specify an empty list to remove all * notification topics.

*/ inline void SetNotificationARNs(Aws::Vector&& value) { m_notificationARNsHasBeenSet = true; m_notificationARNs = std::move(value); } /** *

Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that * CloudFormation associates with the stack. Specify an empty list to remove all * notification topics.

*/ inline UpdateStackRequest& WithNotificationARNs(const Aws::Vector& value) { SetNotificationARNs(value); return *this;} /** *

Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that * CloudFormation associates with the stack. Specify an empty list to remove all * notification topics.

*/ inline UpdateStackRequest& WithNotificationARNs(Aws::Vector&& value) { SetNotificationARNs(std::move(value)); return *this;} /** *

Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that * CloudFormation associates with the stack. Specify an empty list to remove all * notification topics.

*/ inline UpdateStackRequest& AddNotificationARNs(const Aws::String& value) { m_notificationARNsHasBeenSet = true; m_notificationARNs.push_back(value); return *this; } /** *

Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that * CloudFormation associates with the stack. Specify an empty list to remove all * notification topics.

*/ inline UpdateStackRequest& AddNotificationARNs(Aws::String&& value) { m_notificationARNsHasBeenSet = true; m_notificationARNs.push_back(std::move(value)); return *this; } /** *

Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that * CloudFormation associates with the stack. Specify an empty list to remove all * notification topics.

*/ inline UpdateStackRequest& AddNotificationARNs(const char* value) { m_notificationARNsHasBeenSet = true; m_notificationARNs.push_back(value); return *this; } /** *

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to supported resources in the stack. You can specify a maximum number * of 50 tags.

If you don't specify this parameter, CloudFormation doesn't * modify the stack's tags. If you specify an empty value, CloudFormation removes * all associated tags.

*/ inline const Aws::Vector& GetTags() const{ return m_tags; } /** *

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to supported resources in the stack. You can specify a maximum number * of 50 tags.

If you don't specify this parameter, CloudFormation doesn't * modify the stack's tags. If you specify an empty value, CloudFormation removes * all associated tags.

*/ inline bool TagsHasBeenSet() const { return m_tagsHasBeenSet; } /** *

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to supported resources in the stack. You can specify a maximum number * of 50 tags.

If you don't specify this parameter, CloudFormation doesn't * modify the stack's tags. If you specify an empty value, CloudFormation removes * all associated tags.

*/ inline void SetTags(const Aws::Vector& value) { m_tagsHasBeenSet = true; m_tags = value; } /** *

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to supported resources in the stack. You can specify a maximum number * of 50 tags.

If you don't specify this parameter, CloudFormation doesn't * modify the stack's tags. If you specify an empty value, CloudFormation removes * all associated tags.

*/ inline void SetTags(Aws::Vector&& value) { m_tagsHasBeenSet = true; m_tags = std::move(value); } /** *

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to supported resources in the stack. You can specify a maximum number * of 50 tags.

If you don't specify this parameter, CloudFormation doesn't * modify the stack's tags. If you specify an empty value, CloudFormation removes * all associated tags.

*/ inline UpdateStackRequest& WithTags(const Aws::Vector& value) { SetTags(value); return *this;} /** *

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to supported resources in the stack. You can specify a maximum number * of 50 tags.

If you don't specify this parameter, CloudFormation doesn't * modify the stack's tags. If you specify an empty value, CloudFormation removes * all associated tags.

*/ inline UpdateStackRequest& WithTags(Aws::Vector&& value) { SetTags(std::move(value)); return *this;} /** *

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to supported resources in the stack. You can specify a maximum number * of 50 tags.

If you don't specify this parameter, CloudFormation doesn't * modify the stack's tags. If you specify an empty value, CloudFormation removes * all associated tags.

*/ inline UpdateStackRequest& AddTags(const Tag& value) { m_tagsHasBeenSet = true; m_tags.push_back(value); return *this; } /** *

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to supported resources in the stack. You can specify a maximum number * of 50 tags.

If you don't specify this parameter, CloudFormation doesn't * modify the stack's tags. If you specify an empty value, CloudFormation removes * all associated tags.

*/ inline UpdateStackRequest& AddTags(Tag&& value) { m_tagsHasBeenSet = true; m_tags.push_back(std::move(value)); return *this; } /** *

Preserve the state of previously provisioned resources when an operation * fails.

Default: False

*/ inline bool GetDisableRollback() const{ return m_disableRollback; } /** *

Preserve the state of previously provisioned resources when an operation * fails.

Default: False

*/ inline bool DisableRollbackHasBeenSet() const { return m_disableRollbackHasBeenSet; } /** *

Preserve the state of previously provisioned resources when an operation * fails.

Default: False

*/ inline void SetDisableRollback(bool value) { m_disableRollbackHasBeenSet = true; m_disableRollback = value; } /** *

Preserve the state of previously provisioned resources when an operation * fails.

Default: False

*/ inline UpdateStackRequest& WithDisableRollback(bool value) { SetDisableRollback(value); return *this;} /** *

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

All events triggered by a given stack operation are * assigned the same client request token, which you can use to track operations. * For example, if you execute a CreateStack operation with the token * token1, then all the StackEvents generated by that * operation will have ClientRequestToken set as * token1.

In the console, stack operations display the client * request token on the Events tab. Stack operations that are initiated from the * console use the token format Console-StackOperation-ID, which helps you * easily identify the stack operation . For example, if you create a stack using * the console, each stack event would be assigned the same token in the following * format: * Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

*/ inline const Aws::String& GetClientRequestToken() const{ return m_clientRequestToken; } /** *

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

All events triggered by a given stack operation are * assigned the same client request token, which you can use to track operations. * For example, if you execute a CreateStack operation with the token * token1, then all the StackEvents generated by that * operation will have ClientRequestToken set as * token1.

In the console, stack operations display the client * request token on the Events tab. Stack operations that are initiated from the * console use the token format Console-StackOperation-ID, which helps you * easily identify the stack operation . For example, if you create a stack using * the console, each stack event would be assigned the same token in the following * format: * Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

*/ inline bool ClientRequestTokenHasBeenSet() const { return m_clientRequestTokenHasBeenSet; } /** *

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

All events triggered by a given stack operation are * assigned the same client request token, which you can use to track operations. * For example, if you execute a CreateStack operation with the token * token1, then all the StackEvents generated by that * operation will have ClientRequestToken set as * token1.

In the console, stack operations display the client * request token on the Events tab. Stack operations that are initiated from the * console use the token format Console-StackOperation-ID, which helps you * easily identify the stack operation . For example, if you create a stack using * the console, each stack event would be assigned the same token in the following * format: * Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

*/ inline void SetClientRequestToken(const Aws::String& value) { m_clientRequestTokenHasBeenSet = true; m_clientRequestToken = value; } /** *

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

All events triggered by a given stack operation are * assigned the same client request token, which you can use to track operations. * For example, if you execute a CreateStack operation with the token * token1, then all the StackEvents generated by that * operation will have ClientRequestToken set as * token1.

In the console, stack operations display the client * request token on the Events tab. Stack operations that are initiated from the * console use the token format Console-StackOperation-ID, which helps you * easily identify the stack operation . For example, if you create a stack using * the console, each stack event would be assigned the same token in the following * format: * Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

*/ inline void SetClientRequestToken(Aws::String&& value) { m_clientRequestTokenHasBeenSet = true; m_clientRequestToken = std::move(value); } /** *

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

All events triggered by a given stack operation are * assigned the same client request token, which you can use to track operations. * For example, if you execute a CreateStack operation with the token * token1, then all the StackEvents generated by that * operation will have ClientRequestToken set as * token1.

In the console, stack operations display the client * request token on the Events tab. Stack operations that are initiated from the * console use the token format Console-StackOperation-ID, which helps you * easily identify the stack operation . For example, if you create a stack using * the console, each stack event would be assigned the same token in the following * format: * Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

*/ inline void SetClientRequestToken(const char* value) { m_clientRequestTokenHasBeenSet = true; m_clientRequestToken.assign(value); } /** *

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

All events triggered by a given stack operation are * assigned the same client request token, which you can use to track operations. * For example, if you execute a CreateStack operation with the token * token1, then all the StackEvents generated by that * operation will have ClientRequestToken set as * token1.

In the console, stack operations display the client * request token on the Events tab. Stack operations that are initiated from the * console use the token format Console-StackOperation-ID, which helps you * easily identify the stack operation . For example, if you create a stack using * the console, each stack event would be assigned the same token in the following * format: * Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

*/ inline UpdateStackRequest& WithClientRequestToken(const Aws::String& value) { SetClientRequestToken(value); return *this;} /** *

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

All events triggered by a given stack operation are * assigned the same client request token, which you can use to track operations. * For example, if you execute a CreateStack operation with the token * token1, then all the StackEvents generated by that * operation will have ClientRequestToken set as * token1.

In the console, stack operations display the client * request token on the Events tab. Stack operations that are initiated from the * console use the token format Console-StackOperation-ID, which helps you * easily identify the stack operation . For example, if you create a stack using * the console, each stack event would be assigned the same token in the following * format: * Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

*/ inline UpdateStackRequest& WithClientRequestToken(Aws::String&& value) { SetClientRequestToken(std::move(value)); return *this;} /** *

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

All events triggered by a given stack operation are * assigned the same client request token, which you can use to track operations. * For example, if you execute a CreateStack operation with the token * token1, then all the StackEvents generated by that * operation will have ClientRequestToken set as * token1.

In the console, stack operations display the client * request token on the Events tab. Stack operations that are initiated from the * console use the token format Console-StackOperation-ID, which helps you * easily identify the stack operation . For example, if you create a stack using * the console, each stack event would be assigned the same token in the following * format: * Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002.

*/ inline UpdateStackRequest& WithClientRequestToken(const char* value) { SetClientRequestToken(value); return *this;} /** *

This deletion policy deletes newly created resources, but retains existing * resources, when a stack operation is rolled back. This ensures new, empty, and * unused resources are deleted, while critical resources and their data are * retained. RetainExceptOnCreate can be specified for any resource * that supports the * DeletionPolicy attribute.

*/ inline bool GetRetainExceptOnCreate() const{ return m_retainExceptOnCreate; } /** *

This deletion policy deletes newly created resources, but retains existing * resources, when a stack operation is rolled back. This ensures new, empty, and * unused resources are deleted, while critical resources and their data are * retained. RetainExceptOnCreate can be specified for any resource * that supports the * DeletionPolicy attribute.

*/ inline bool RetainExceptOnCreateHasBeenSet() const { return m_retainExceptOnCreateHasBeenSet; } /** *

This deletion policy deletes newly created resources, but retains existing * resources, when a stack operation is rolled back. This ensures new, empty, and * unused resources are deleted, while critical resources and their data are * retained. RetainExceptOnCreate can be specified for any resource * that supports the * DeletionPolicy attribute.

*/ inline void SetRetainExceptOnCreate(bool value) { m_retainExceptOnCreateHasBeenSet = true; m_retainExceptOnCreate = value; } /** *

This deletion policy deletes newly created resources, but retains existing * resources, when a stack operation is rolled back. This ensures new, empty, and * unused resources are deleted, while critical resources and their data are * retained. RetainExceptOnCreate can be specified for any resource * that supports the * DeletionPolicy attribute.

*/ inline UpdateStackRequest& WithRetainExceptOnCreate(bool value) { SetRetainExceptOnCreate(value); return *this;} private: Aws::String m_stackName; bool m_stackNameHasBeenSet = false; Aws::String m_templateBody; bool m_templateBodyHasBeenSet = false; Aws::String m_templateURL; bool m_templateURLHasBeenSet = false; bool m_usePreviousTemplate; bool m_usePreviousTemplateHasBeenSet = false; Aws::String m_stackPolicyDuringUpdateBody; bool m_stackPolicyDuringUpdateBodyHasBeenSet = false; Aws::String m_stackPolicyDuringUpdateURL; bool m_stackPolicyDuringUpdateURLHasBeenSet = false; Aws::Vector m_parameters; bool m_parametersHasBeenSet = false; Aws::Vector m_capabilities; bool m_capabilitiesHasBeenSet = false; Aws::Vector m_resourceTypes; bool m_resourceTypesHasBeenSet = false; Aws::String m_roleARN; bool m_roleARNHasBeenSet = false; RollbackConfiguration m_rollbackConfiguration; bool m_rollbackConfigurationHasBeenSet = false; Aws::String m_stackPolicyBody; bool m_stackPolicyBodyHasBeenSet = false; Aws::String m_stackPolicyURL; bool m_stackPolicyURLHasBeenSet = false; Aws::Vector m_notificationARNs; bool m_notificationARNsHasBeenSet = false; Aws::Vector m_tags; bool m_tagsHasBeenSet = false; bool m_disableRollback; bool m_disableRollbackHasBeenSet = false; Aws::String m_clientRequestToken; bool m_clientRequestTokenHasBeenSet = false; bool m_retainExceptOnCreate; bool m_retainExceptOnCreateHasBeenSet = false; }; } // namespace Model } // namespace CloudFormation } // namespace Aws