1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`ExecuteChangeSet`](crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`change_set_name(impl Into<String>)`](crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder::change_set_name) / [`set_change_set_name(Option<String>)`](crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder::set_change_set_name):<br>required: **true**<br><p>The name or Amazon Resource Name (ARN) of the change set that you want use to update the specified stack.</p><br>
    ///   - [`stack_name(impl Into<String>)`](crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder::stack_name) / [`set_stack_name(Option<String>)`](crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder::set_stack_name):<br>required: **false**<br><p>If you specified the name of a change set, specify the stack name or Amazon Resource Name (ARN) that's associated with the change set you want to execute.</p><br>
    ///   - [`client_request_token(impl Into<String>)`](crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder::client_request_token) / [`set_client_request_token(Option<String>)`](crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder::set_client_request_token):<br>required: **false**<br><p>A unique identifier for this <code>ExecuteChangeSet</code> request. Specify this token if you plan to retry requests so that CloudFormation knows that you're not attempting to execute a change set to update a stack with the same name. You might retry <code>ExecuteChangeSet</code> requests to ensure that CloudFormation successfully received them.</p><br>
    ///   - [`disable_rollback(bool)`](crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder::disable_rollback) / [`set_disable_rollback(Option<bool>)`](crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder::set_disable_rollback):<br>required: **false**<br><p>Preserves the state of previously provisioned resources when an operation fails. This parameter can't be specified when the <code>OnStackFailure</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateChangeSet.html"> <code>CreateChangeSet</code> </a> API operation was specified.</p> <ul>  <li>   <p><code>True</code> - if the stack creation fails, do nothing. This is equivalent to specifying <code>DO_NOTHING</code> for the <code>OnStackFailure</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateChangeSet.html"> <code>CreateChangeSet</code> </a> API operation.</p></li>  <li>   <p><code>False</code> - if the stack creation fails, roll back the stack. This is equivalent to specifying <code>ROLLBACK</code> for the <code>OnStackFailure</code> parameter to the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateChangeSet.html"> <code>CreateChangeSet</code> </a> API operation.</p></li> </ul> <p>Default: <code>True</code></p><br>
    ///   - [`retain_except_on_create(bool)`](crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder::retain_except_on_create) / [`set_retain_except_on_create(Option<bool>)`](crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder::set_retain_except_on_create):<br>required: **false**<br><p>When set to <code>true</code>, newly created resources are deleted when the operation rolls back. This includes newly created resources marked with a deletion policy of <code>Retain</code>.</p> <p>Default: <code>false</code></p><br>
    /// - On success, responds with [`ExecuteChangeSetOutput`](crate::operation::execute_change_set::ExecuteChangeSetOutput)
    /// - On failure, responds with [`SdkError<ExecuteChangeSetError>`](crate::operation::execute_change_set::ExecuteChangeSetError)
    pub fn execute_change_set(&self) -> crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder {
        crate::operation::execute_change_set::builders::ExecuteChangeSetFluentBuilder::new(self.handle.clone())
    }
}