:doc:`Stack <index>` / Action / cancel_update

*************
cancel_update
*************



.. py:method:: CloudFormation.Stack.cancel_update(**kwargs)

  

  Cancels an update on the specified stack. If the call completes successfully, the stack rolls back the update and reverts to the previous stack configuration.

   

  .. note::

    

    You can cancel only stacks that are in the ``UPDATE_IN_PROGRESS`` state.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CancelUpdateStack>`_  


  **Request Syntax**
  ::

    response = stack.cancel_update(
        ClientRequestToken='string'
    )
    
  :type ClientRequestToken: string
  :param ClientRequestToken: 

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

    

  
  
  :returns: None