/*
 * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License").
 * You may not use this file except in compliance with the License.
 * A copy of the License is located at
 * 
 *  http://aws.amazon.com/apache2.0
 * 
 * or in the "license" file accompanying this file. This file is distributed
 * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
 * express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */

/*
 * Do not modify this file. This file is generated from the cloudformation-2010-05-15.normal.json service model.
 */
using System;
using System.Collections.Generic;
using System.Xml.Serialization;
using System.Text;
using System.IO;
using System.Net;

using Amazon.Runtime;
using Amazon.Runtime.Internal;

namespace Amazon.CloudFormation.Model
{
    /// <summary>
    /// Container for the parameters to the ContinueUpdateRollback operation.
    /// For a specified stack that's in the <code>UPDATE_ROLLBACK_FAILED</code> state, continues
    /// rolling it back to the <code>UPDATE_ROLLBACK_COMPLETE</code> state. Depending on the
    /// cause of the failure, you can manually <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed">
    /// fix the error</a> and continue the rollback. By continuing the rollback, you can return
    /// your stack to a working state (the <code>UPDATE_ROLLBACK_COMPLETE</code> state), and
    /// then try to update the stack again.
    /// 
    ///  
    /// <para>
    /// A stack goes into the <code>UPDATE_ROLLBACK_FAILED</code> state when CloudFormation
    /// can't roll back all changes after a failed stack update. For example, you might have
    /// a stack that's rolling back to an old database instance that was deleted outside of
    /// CloudFormation. Because CloudFormation doesn't know the database was deleted, it assumes
    /// that the database instance still exists and attempts to roll back to it, causing the
    /// update rollback to fail.
    /// </para>
    /// </summary>
    public partial class ContinueUpdateRollbackRequest : AmazonCloudFormationRequest
    {
        private string _clientRequestToken;
        private List<string> _resourcesToSkip = new List<string>();
        private string _roleARN;
        private string _stackName;

        /// <summary>
        /// Gets and sets the property ClientRequestToken. 
        /// <para>
        /// A unique identifier for this <code>ContinueUpdateRollback</code> request. Specify
        /// this token if you plan to retry requests so that CloudFormation knows that you're
        /// not attempting to continue the rollback to a stack with the same name. You might retry
        /// <code>ContinueUpdateRollback</code> requests to ensure that CloudFormation successfully
        /// received them.
        /// </para>
        /// </summary>
        [AWSProperty(Min=1, Max=128)]
        public string ClientRequestToken
        {
            get { return this._clientRequestToken; }
            set { this._clientRequestToken = value; }
        }

        // Check to see if ClientRequestToken property is set
        internal bool IsSetClientRequestToken()
        {
            return this._clientRequestToken != null;
        }

        /// <summary>
        /// Gets and sets the property ResourcesToSkip. 
        /// <para>
        /// A list of the logical IDs of the resources that CloudFormation skips during the continue
        /// update rollback operation. You can specify only resources that are in the <code>UPDATE_FAILED</code>
        /// state because a rollback failed. You can't specify resources that are in the <code>UPDATE_FAILED</code>
        /// state for other reasons, for example, because an update was canceled. To check why
        /// a resource update failed, use the <a>DescribeStackResources</a> action, and view the
        /// resource status reason.
        /// </para>
        ///  <important> 
        /// <para>
        /// Specify this property to skip rolling back resources that CloudFormation can't successfully
        /// roll back. We recommend that you <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed">
        /// troubleshoot</a> resources before skipping them. CloudFormation sets the status of
        /// the specified resources to <code>UPDATE_COMPLETE</code> and continues to roll back
        /// the stack. After the rollback is complete, the state of the skipped resources will
        /// be inconsistent with the state of the resources in the stack template. Before performing
        /// another stack update, you must update the stack or resources to be consistent with
        /// each other. If you don't, subsequent stack updates might fail, and the stack will
        /// become unrecoverable.
        /// </para>
        ///  </important> 
        /// <para>
        /// Specify the minimum number of resources required to successfully roll back your stack.
        /// For example, a failed resource update might cause dependent resources to fail. In
        /// this case, it might not be necessary to skip the dependent resources.
        /// </para>
        ///  
        /// <para>
        /// To skip resources that are part of nested stacks, use the following format: <code>NestedStackName.ResourceLogicalID</code>.
        /// If you want to specify the logical ID of a stack resource (<code>Type: AWS::CloudFormation::Stack</code>)
        /// in the <code>ResourcesToSkip</code> list, then its corresponding embedded stack must
        /// be in one of the following states: <code>DELETE_IN_PROGRESS</code>, <code>DELETE_COMPLETE</code>,
        /// or <code>DELETE_FAILED</code>.
        /// </para>
        ///  <note> 
        /// <para>
        /// Don't confuse a child stack's name with its corresponding logical ID defined in the
        /// parent stack. For an example of a continue update rollback operation with nested stacks,
        /// see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-continueupdaterollback.html#nested-stacks">Using
        /// ResourcesToSkip to recover a nested stacks hierarchy</a>.
        /// </para>
        ///  </note>
        /// </summary>
        public List<string> ResourcesToSkip
        {
            get { return this._resourcesToSkip; }
            set { this._resourcesToSkip = value; }
        }

        // Check to see if ResourcesToSkip property is set
        internal bool IsSetResourcesToSkip()
        {
            return this._resourcesToSkip != null && this._resourcesToSkip.Count > 0; 
        }

        /// <summary>
        /// Gets and sets the property RoleARN. 
        /// <para>
        /// The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that
        /// CloudFormation assumes to roll back 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 permission.
        /// </para>
        ///  
        /// <para>
        /// 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's
        /// generated from your user credentials.
        /// </para>
        /// </summary>
        [AWSProperty(Min=20, Max=2048)]
        public string RoleARN
        {
            get { return this._roleARN; }
            set { this._roleARN = value; }
        }

        // Check to see if RoleARN property is set
        internal bool IsSetRoleARN()
        {
            return this._roleARN != null;
        }

        /// <summary>
        /// Gets and sets the property StackName. 
        /// <para>
        /// The name or the unique ID of the stack that you want to continue rolling back.
        /// </para>
        ///  <note> 
        /// <para>
        /// Don't specify the name of a nested stack (a stack that was created by using the <code>AWS::CloudFormation::Stack</code>
        /// resource). Instead, use this operation on the parent stack (the stack that contains
        /// the <code>AWS::CloudFormation::Stack</code> resource).
        /// </para>
        ///  </note>
        /// </summary>
        [AWSProperty(Required=true, Min=1)]
        public string StackName
        {
            get { return this._stackName; }
            set { this._stackName = value; }
        }

        // Check to see if StackName property is set
        internal bool IsSetStackName()
        {
            return this._stackName != null;
        }

    }
}