/** * 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 #include namespace Aws { namespace CloudFormation { namespace Model { /** *

The input for CreateStack action.

See Also:

AWS * API Reference

*/ class AWS_CLOUDFORMATION_API CreateStackRequest : public CloudFormationRequest { public: CreateStackRequest(); // 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 "CreateStack"; } Aws::String SerializePayload() const override; protected: void DumpBodyToUrl(Aws::Http::URI& uri ) const override; public: /** *

The name that is associated with the stack. The name must be unique in the * Region in which you are creating the stack.

A stack name can * contain only alphanumeric characters (case sensitive) and hyphens. It must start * with an alphabetical character and cannot be longer than 128 characters.

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

The name that is associated with the stack. The name must be unique in the * Region in which you are creating the stack.

A stack name can * contain only alphanumeric characters (case sensitive) and hyphens. It must start * with an alphabetical character and cannot be longer than 128 characters.

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

The name that is associated with the stack. The name must be unique in the * Region in which you are creating the stack.

A stack name can * contain only alphanumeric characters (case sensitive) and hyphens. It must start * with an alphabetical character and cannot be longer than 128 characters.

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

The name that is associated with the stack. The name must be unique in the * Region in which you are creating the stack.

A stack name can * contain only alphanumeric characters (case sensitive) and hyphens. It must start * with an alphabetical character and cannot be longer than 128 characters.

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

The name that is associated with the stack. The name must be unique in the * Region in which you are creating the stack.

A stack name can * contain only alphanumeric characters (case sensitive) and hyphens. It must start * with an alphabetical character and cannot be longer than 128 characters.

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

The name that is associated with the stack. The name must be unique in the * Region in which you are creating the stack.

A stack name can * contain only alphanumeric characters (case sensitive) and hyphens. It must start * with an alphabetical character and cannot be longer than 128 characters.

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

The name that is associated with the stack. The name must be unique in the * Region in which you are creating the stack.

A stack name can * contain only alphanumeric characters (case sensitive) and hyphens. It must start * with an alphabetical character and cannot be longer than 128 characters.

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

The name that is associated with the stack. The name must be unique in the * Region in which you are creating the stack.

A stack name can * contain only alphanumeric characters (case sensitive) and hyphens. It must start * with an alphabetical character and cannot be longer than 128 characters.

* */ inline CreateStackRequest& 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 either the TemplateBody or the TemplateURL * parameter, but not both.

*/ 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 either the TemplateBody or the TemplateURL * parameter, but not both.

*/ 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 either the TemplateBody or the TemplateURL * parameter, but not both.

*/ 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 either the TemplateBody or the TemplateURL * parameter, but not both.

*/ 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 either the TemplateBody or the TemplateURL * parameter, but not both.

*/ 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 either the TemplateBody or the TemplateURL * parameter, but not both.

*/ inline CreateStackRequest& 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 either the TemplateBody or the TemplateURL * parameter, but not both.

*/ inline CreateStackRequest& 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 either the TemplateBody or the TemplateURL * parameter, but not both.

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

Location of file containing the template body. The URL must point to a * template (max size: 460,800 bytes) that is located in an Amazon S3 bucket or a * Systems Manager document. For more information, go to the Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify either the TemplateBody or the TemplateURL * parameter, but not both.

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

Location of file containing the template body. The URL must point to a * template (max size: 460,800 bytes) that is located in an Amazon S3 bucket or a * Systems Manager document. For more information, go to the Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify either the TemplateBody or the TemplateURL * parameter, but not both.

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

Location of file containing the template body. The URL must point to a * template (max size: 460,800 bytes) that is located in an Amazon S3 bucket or a * Systems Manager document. For more information, go to the Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify either the TemplateBody or the TemplateURL * parameter, but not both.

*/ 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 (max size: 460,800 bytes) that is located in an Amazon S3 bucket or a * Systems Manager document. For more information, go to the Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify either the TemplateBody or the TemplateURL * parameter, but not both.

*/ 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 (max size: 460,800 bytes) that is located in an Amazon S3 bucket or a * Systems Manager document. For more information, go to the Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify either the TemplateBody or the TemplateURL * parameter, but not both.

*/ 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 (max size: 460,800 bytes) that is located in an Amazon S3 bucket or a * Systems Manager document. For more information, go to the Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify either the TemplateBody or the TemplateURL * parameter, but not both.

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

Location of file containing the template body. The URL must point to a * template (max size: 460,800 bytes) that is located in an Amazon S3 bucket or a * Systems Manager document. For more information, go to the Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify either the TemplateBody or the TemplateURL * parameter, but not both.

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

Location of file containing the template body. The URL must point to a * template (max size: 460,800 bytes) that is located in an Amazon S3 bucket or a * Systems Manager document. For more information, go to the Template * Anatomy in the CloudFormation User Guide.

Conditional: You must * specify either the TemplateBody or the TemplateURL * parameter, but not both.

*/ inline CreateStackRequest& WithTemplateURL(const char* value) { SetTemplateURL(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 CreateStackRequest& 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 CreateStackRequest& 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 CreateStackRequest& 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 CreateStackRequest& AddParameters(Parameter&& value) { m_parametersHasBeenSet = true; m_parameters.push_back(std::move(value)); return *this; } /** *

Set to true to disable rollback of the stack if stack creation * failed. You can specify either DisableRollback or * OnFailure, but not both.

Default: false

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

Set to true to disable rollback of the stack if stack creation * failed. You can specify either DisableRollback or * OnFailure, but not both.

Default: false

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

Set to true to disable rollback of the stack if stack creation * failed. You can specify either DisableRollback or * OnFailure, but not both.

Default: false

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

Set to true to disable rollback of the stack if stack creation * failed. You can specify either DisableRollback or * OnFailure, but not both.

Default: false

*/ inline CreateStackRequest& WithDisableRollback(bool value) { SetDisableRollback(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 CreateStackRequest& 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 CreateStackRequest& WithRollbackConfiguration(RollbackConfiguration&& value) { SetRollbackConfiguration(std::move(value)); return *this;} /** *

The amount of time that can pass before the stack status becomes * CREATE_FAILED; if DisableRollback is not set or is set to * false, the stack will be rolled back.

*/ inline int GetTimeoutInMinutes() const{ return m_timeoutInMinutes; } /** *

The amount of time that can pass before the stack status becomes * CREATE_FAILED; if DisableRollback is not set or is set to * false, the stack will be rolled back.

*/ inline bool TimeoutInMinutesHasBeenSet() const { return m_timeoutInMinutesHasBeenSet; } /** *

The amount of time that can pass before the stack status becomes * CREATE_FAILED; if DisableRollback is not set or is set to * false, the stack will be rolled back.

*/ inline void SetTimeoutInMinutes(int value) { m_timeoutInMinutesHasBeenSet = true; m_timeoutInMinutes = value; } /** *

The amount of time that can pass before the stack status becomes * CREATE_FAILED; if DisableRollback is not set or is set to * false, the stack will be rolled back.

*/ inline CreateStackRequest& WithTimeoutInMinutes(int value) { SetTimeoutInMinutes(value); return *this;} /** *

The Simple Notification Service (SNS) topic ARNs to publish stack related * events. You can find your SNS topic ARNs using the SNS console or your Command * Line Interface (CLI).

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

The Simple Notification Service (SNS) topic ARNs to publish stack related * events. You can find your SNS topic ARNs using the SNS console or your Command * Line Interface (CLI).

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

The Simple Notification Service (SNS) topic ARNs to publish stack related * events. You can find your SNS topic ARNs using the SNS console or your Command * Line Interface (CLI).

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

The Simple Notification Service (SNS) topic ARNs to publish stack related * events. You can find your SNS topic ARNs using the SNS console or your Command * Line Interface (CLI).

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

The Simple Notification Service (SNS) topic ARNs to publish stack related * events. You can find your SNS topic ARNs using the SNS console or your Command * Line Interface (CLI).

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

The Simple Notification Service (SNS) topic ARNs to publish stack related * events. You can find your SNS topic ARNs using the SNS console or your Command * Line Interface (CLI).

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

The Simple Notification Service (SNS) topic ARNs to publish stack related * events. You can find your SNS topic ARNs using the SNS console or your Command * Line Interface (CLI).

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

The Simple Notification Service (SNS) topic ARNs to publish stack related * events. You can find your SNS topic ARNs using the SNS console or your Command * Line Interface (CLI).

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

The Simple Notification Service (SNS) topic ARNs to publish stack related * events. You can find your SNS topic ARNs using the SNS console or your Command * Line Interface (CLI).

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

In some cases, you must explicitly acknowledge that your stack template * contains certain capabilities in order for CloudFormation to create 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 recommend 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 creating the stack. If your stack template contains one * or more macros, and you choose to create 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 * create a stack from a stack template that contains macros and nested * stacks, you must create the stack directly from the template using this * capability.

    You should only create 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 create 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 recommend 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 creating the stack. If your stack template contains one * or more macros, and you choose to create 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 * create a stack from a stack template that contains macros and nested * stacks, you must create the stack directly from the template using this * capability.

    You should only create 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 create 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 recommend 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 creating the stack. If your stack template contains one * or more macros, and you choose to create 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 * create a stack from a stack template that contains macros and nested * stacks, you must create the stack directly from the template using this * capability.

    You should only create 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 create 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 recommend 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 creating the stack. If your stack template contains one * or more macros, and you choose to create 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 * create a stack from a stack template that contains macros and nested * stacks, you must create the stack directly from the template using this * capability.

    You should only create 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 create 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 recommend 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 creating the stack. If your stack template contains one * or more macros, and you choose to create 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 * create a stack from a stack template that contains macros and nested * stacks, you must create the stack directly from the template using this * capability.

    You should only create 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 CreateStackRequest& 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 create 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 recommend 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 creating the stack. If your stack template contains one * or more macros, and you choose to create 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 * create a stack from a stack template that contains macros and nested * stacks, you must create the stack directly from the template using this * capability.

    You should only create 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 CreateStackRequest& 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 create 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 recommend 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 creating the stack. If your stack template contains one * or more macros, and you choose to create 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 * create a stack from a stack template that contains macros and nested * stacks, you must create the stack directly from the template using this * capability.

    You should only create 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 CreateStackRequest& 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 create 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 recommend 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 creating the stack. If your stack template contains one * or more macros, and you choose to create 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 * create a stack from a stack template that contains macros and nested * stacks, you must create the stack directly from the template using this * capability.

    You should only create 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 CreateStackRequest& 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 * create stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance. Use the * following syntax to describe template resource types: AWS::* (for * all Amazon Web Services resources), Custom::* (for all custom * resources), Custom::logical_ID (for a specific custom * resource), AWS::service_name::* (for all resources of a * particular Amazon Web Services service), and * AWS::service_name::resource_logical_ID (for a * specific Amazon Web Services resource).

If the list of resource types * doesn't include a resource that you're creating, the stack creation 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 * create stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance. Use the * following syntax to describe template resource types: AWS::* (for * all Amazon Web Services resources), Custom::* (for all custom * resources), Custom::logical_ID (for a specific custom * resource), AWS::service_name::* (for all resources of a * particular Amazon Web Services service), and * AWS::service_name::resource_logical_ID (for a * specific Amazon Web Services resource).

If the list of resource types * doesn't include a resource that you're creating, the stack creation 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 * create stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance. Use the * following syntax to describe template resource types: AWS::* (for * all Amazon Web Services resources), Custom::* (for all custom * resources), Custom::logical_ID (for a specific custom * resource), AWS::service_name::* (for all resources of a * particular Amazon Web Services service), and * AWS::service_name::resource_logical_ID (for a * specific Amazon Web Services resource).

If the list of resource types * doesn't include a resource that you're creating, the stack creation 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 * create stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance. Use the * following syntax to describe template resource types: AWS::* (for * all Amazon Web Services resources), Custom::* (for all custom * resources), Custom::logical_ID (for a specific custom * resource), AWS::service_name::* (for all resources of a * particular Amazon Web Services service), and * AWS::service_name::resource_logical_ID (for a * specific Amazon Web Services resource).

If the list of resource types * doesn't include a resource that you're creating, the stack creation 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 * create stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance. Use the * following syntax to describe template resource types: AWS::* (for * all Amazon Web Services resources), Custom::* (for all custom * resources), Custom::logical_ID (for a specific custom * resource), AWS::service_name::* (for all resources of a * particular Amazon Web Services service), and * AWS::service_name::resource_logical_ID (for a * specific Amazon Web Services resource).

If the list of resource types * doesn't include a resource that you're creating, the stack creation 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 CreateStackRequest& WithResourceTypes(const Aws::Vector& value) { SetResourceTypes(value); return *this;} /** *

The template resource types that you have permissions to work with for this * create stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance. Use the * following syntax to describe template resource types: AWS::* (for * all Amazon Web Services resources), Custom::* (for all custom * resources), Custom::logical_ID (for a specific custom * resource), AWS::service_name::* (for all resources of a * particular Amazon Web Services service), and * AWS::service_name::resource_logical_ID (for a * specific Amazon Web Services resource).

If the list of resource types * doesn't include a resource that you're creating, the stack creation 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 CreateStackRequest& WithResourceTypes(Aws::Vector&& value) { SetResourceTypes(std::move(value)); return *this;} /** *

The template resource types that you have permissions to work with for this * create stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance. Use the * following syntax to describe template resource types: AWS::* (for * all Amazon Web Services resources), Custom::* (for all custom * resources), Custom::logical_ID (for a specific custom * resource), AWS::service_name::* (for all resources of a * particular Amazon Web Services service), and * AWS::service_name::resource_logical_ID (for a * specific Amazon Web Services resource).

If the list of resource types * doesn't include a resource that you're creating, the stack creation 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 CreateStackRequest& 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 * create stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance. Use the * following syntax to describe template resource types: AWS::* (for * all Amazon Web Services resources), Custom::* (for all custom * resources), Custom::logical_ID (for a specific custom * resource), AWS::service_name::* (for all resources of a * particular Amazon Web Services service), and * AWS::service_name::resource_logical_ID (for a * specific Amazon Web Services resource).

If the list of resource types * doesn't include a resource that you're creating, the stack creation 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 CreateStackRequest& 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 * create stack action, such as AWS::EC2::Instance, * AWS::EC2::*, or Custom::MyCustomInstance. Use the * following syntax to describe template resource types: AWS::* (for * all Amazon Web Services resources), Custom::* (for all custom * resources), Custom::logical_ID (for a specific custom * resource), AWS::service_name::* (for all resources of a * particular Amazon Web Services service), and * AWS::service_name::resource_logical_ID (for a * specific Amazon Web Services resource).

If the list of resource types * doesn't include a resource that you're creating, the stack creation 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 CreateStackRequest& 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 create 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. As long as 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 create 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. As long as 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 create 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. As long as 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 create 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. As long as 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 create 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. As long as 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 create 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. As long as 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 CreateStackRequest& 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 create 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. As long as 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 CreateStackRequest& 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 create 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. As long as 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 CreateStackRequest& WithRoleARN(const char* value) { SetRoleARN(value); return *this;} /** *

Determines what action will be taken if stack creation fails. This must be * one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either * OnFailure or DisableRollback, but not both.

*

Default: ROLLBACK

*/ inline const OnFailure& GetOnFailure() const{ return m_onFailure; } /** *

Determines what action will be taken if stack creation fails. This must be * one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either * OnFailure or DisableRollback, but not both.

*

Default: ROLLBACK

*/ inline bool OnFailureHasBeenSet() const { return m_onFailureHasBeenSet; } /** *

Determines what action will be taken if stack creation fails. This must be * one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either * OnFailure or DisableRollback, but not both.

*

Default: ROLLBACK

*/ inline void SetOnFailure(const OnFailure& value) { m_onFailureHasBeenSet = true; m_onFailure = value; } /** *

Determines what action will be taken if stack creation fails. This must be * one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either * OnFailure or DisableRollback, but not both.

*

Default: ROLLBACK

*/ inline void SetOnFailure(OnFailure&& value) { m_onFailureHasBeenSet = true; m_onFailure = std::move(value); } /** *

Determines what action will be taken if stack creation fails. This must be * one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either * OnFailure or DisableRollback, but not both.

*

Default: ROLLBACK

*/ inline CreateStackRequest& WithOnFailure(const OnFailure& value) { SetOnFailure(value); return *this;} /** *

Determines what action will be taken if stack creation fails. This must be * one of: DO_NOTHING, ROLLBACK, or DELETE. You can specify either * OnFailure or DisableRollback, but not both.

*

Default: ROLLBACK

*/ inline CreateStackRequest& WithOnFailure(OnFailure&& value) { SetOnFailure(std::move(value)); return *this;} /** *

Structure containing the stack policy body. For more information, go to * Prevent Updates to Stack Resources in the CloudFormation User Guide. * You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

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

Structure containing the stack policy body. For more information, go to * Prevent Updates to Stack Resources in the CloudFormation User Guide. * You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

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

Structure containing the stack policy body. For more information, go to * Prevent Updates to Stack Resources in the CloudFormation User Guide. * You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

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

Structure containing the stack policy body. For more information, go to * Prevent Updates to Stack Resources in the CloudFormation User Guide. * You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

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

Structure containing the stack policy body. For more information, go to * Prevent Updates to Stack Resources in the CloudFormation User Guide. * You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

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

Structure containing the stack policy body. For more information, go to * Prevent Updates to Stack Resources in the CloudFormation User Guide. * You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

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

Structure containing the stack policy body. For more information, go to * Prevent Updates to Stack Resources in the CloudFormation User Guide. * You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

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

Structure containing the stack policy body. For more information, go to * Prevent Updates to Stack Resources in the CloudFormation User Guide. * You can specify either the StackPolicyBody or the * StackPolicyURL parameter, but not both.

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

Location of a file containing the stack policy. The URL must point to a * policy (maximum size: 16 KB) 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.

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

Location of a file containing the stack policy. The URL must point to a * policy (maximum size: 16 KB) 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.

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

Location of a file containing the stack policy. The URL must point to a * policy (maximum size: 16 KB) 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.

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

Location of a file containing the stack policy. The URL must point to a * policy (maximum size: 16 KB) 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.

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

Location of a file containing the stack policy. The URL must point to a * policy (maximum size: 16 KB) 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.

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

Location of a file containing the stack policy. The URL must point to a * policy (maximum size: 16 KB) 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.

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

Location of a file containing the stack policy. The URL must point to a * policy (maximum size: 16 KB) 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.

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

Location of a file containing the stack policy. The URL must point to a * policy (maximum size: 16 KB) 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.

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

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to the resources created in the stack. A maximum number of 50 tags * can be specified.

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

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to the resources created in the stack. A maximum number of 50 tags * can be specified.

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

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to the resources created in the stack. A maximum number of 50 tags * can be specified.

*/ 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 the resources created in the stack. A maximum number of 50 tags * can be specified.

*/ 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 the resources created in the stack. A maximum number of 50 tags * can be specified.

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

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to the resources created in the stack. A maximum number of 50 tags * can be specified.

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

Key-value pairs to associate with this stack. CloudFormation also propagates * these tags to the resources created in the stack. A maximum number of 50 tags * can be specified.

*/ inline CreateStackRequest& 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 the resources created in the stack. A maximum number of 50 tags * can be specified.

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

A unique identifier for this CreateStack request. Specify this * token if you plan to retry requests so that CloudFormation knows that you're not * attempting to create a stack with the same name. You might retry * CreateStack 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 CreateStack request. Specify this * token if you plan to retry requests so that CloudFormation knows that you're not * attempting to create a stack with the same name. You might retry * CreateStack 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 CreateStack request. Specify this * token if you plan to retry requests so that CloudFormation knows that you're not * attempting to create a stack with the same name. You might retry * CreateStack 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 CreateStack request. Specify this * token if you plan to retry requests so that CloudFormation knows that you're not * attempting to create a stack with the same name. You might retry * CreateStack 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 CreateStack request. Specify this * token if you plan to retry requests so that CloudFormation knows that you're not * attempting to create a stack with the same name. You might retry * CreateStack 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 CreateStack request. Specify this * token if you plan to retry requests so that CloudFormation knows that you're not * attempting to create a stack with the same name. You might retry * CreateStack 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 CreateStackRequest& WithClientRequestToken(const Aws::String& value) { SetClientRequestToken(value); return *this;} /** *

A unique identifier for this CreateStack request. Specify this * token if you plan to retry requests so that CloudFormation knows that you're not * attempting to create a stack with the same name. You might retry * CreateStack 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 CreateStackRequest& WithClientRequestToken(Aws::String&& value) { SetClientRequestToken(std::move(value)); return *this;} /** *

A unique identifier for this CreateStack request. Specify this * token if you plan to retry requests so that CloudFormation knows that you're not * attempting to create a stack with the same name. You might retry * CreateStack 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 CreateStackRequest& WithClientRequestToken(const char* value) { SetClientRequestToken(value); return *this;} /** *

Whether to enable termination protection on the specified stack. If a user * attempts to delete a stack with termination protection enabled, the operation * fails and the stack remains unchanged. For more information, see Protecting * a Stack From Being Deleted in the CloudFormation User Guide. * Termination protection is disabled on stacks by default.

For nested * stacks, termination protection is set on the root stack and cannot be * changed directly on the nested stack.

*/ inline bool GetEnableTerminationProtection() const{ return m_enableTerminationProtection; } /** *

Whether to enable termination protection on the specified stack. If a user * attempts to delete a stack with termination protection enabled, the operation * fails and the stack remains unchanged. For more information, see Protecting * a Stack From Being Deleted in the CloudFormation User Guide. * Termination protection is disabled on stacks by default.

For nested * stacks, termination protection is set on the root stack and cannot be * changed directly on the nested stack.

*/ inline bool EnableTerminationProtectionHasBeenSet() const { return m_enableTerminationProtectionHasBeenSet; } /** *

Whether to enable termination protection on the specified stack. If a user * attempts to delete a stack with termination protection enabled, the operation * fails and the stack remains unchanged. For more information, see Protecting * a Stack From Being Deleted in the CloudFormation User Guide. * Termination protection is disabled on stacks by default.

For nested * stacks, termination protection is set on the root stack and cannot be * changed directly on the nested stack.

*/ inline void SetEnableTerminationProtection(bool value) { m_enableTerminationProtectionHasBeenSet = true; m_enableTerminationProtection = value; } /** *

Whether to enable termination protection on the specified stack. If a user * attempts to delete a stack with termination protection enabled, the operation * fails and the stack remains unchanged. For more information, see Protecting * a Stack From Being Deleted in the CloudFormation User Guide. * Termination protection is disabled on stacks by default.

For nested * stacks, termination protection is set on the root stack and cannot be * changed directly on the nested stack.

*/ inline CreateStackRequest& WithEnableTerminationProtection(bool value) { SetEnableTerminationProtection(value); return *this;} private: Aws::String m_stackName; bool m_stackNameHasBeenSet; Aws::String m_templateBody; bool m_templateBodyHasBeenSet; Aws::String m_templateURL; bool m_templateURLHasBeenSet; Aws::Vector m_parameters; bool m_parametersHasBeenSet; bool m_disableRollback; bool m_disableRollbackHasBeenSet; RollbackConfiguration m_rollbackConfiguration; bool m_rollbackConfigurationHasBeenSet; int m_timeoutInMinutes; bool m_timeoutInMinutesHasBeenSet; Aws::Vector m_notificationARNs; bool m_notificationARNsHasBeenSet; Aws::Vector m_capabilities; bool m_capabilitiesHasBeenSet; Aws::Vector m_resourceTypes; bool m_resourceTypesHasBeenSet; Aws::String m_roleARN; bool m_roleARNHasBeenSet; OnFailure m_onFailure; bool m_onFailureHasBeenSet; Aws::String m_stackPolicyBody; bool m_stackPolicyBodyHasBeenSet; Aws::String m_stackPolicyURL; bool m_stackPolicyURLHasBeenSet; Aws::Vector m_tags; bool m_tagsHasBeenSet; Aws::String m_clientRequestToken; bool m_clientRequestTokenHasBeenSet; bool m_enableTerminationProtection; bool m_enableTerminationProtectionHasBeenSet; }; } // namespace Model } // namespace CloudFormation } // namespace Aws