:doc:`Backup <../../backup>` / Client / cancel_legal_hold

*****************
cancel_legal_hold
*****************



.. py:method:: Backup.Client.cancel_legal_hold(**kwargs)

  

  Removes the specified legal hold on a recovery point. This action can only be performed by a user with sufficient permissions.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/CancelLegalHold>`_  


  **Request Syntax**
  ::

    response = client.cancel_legal_hold(
        LegalHoldId='string',
        CancelDescription='string',
        RetainRecordInDays=123
    )
    
  :type LegalHoldId: string
  :param LegalHoldId: **[REQUIRED]** 

    The ID of the legal hold.

    

  
  :type CancelDescription: string
  :param CancelDescription: **[REQUIRED]** 

    A string the describes the reason for removing the legal hold.

    

  
  :type RetainRecordInDays: integer
  :param RetainRecordInDays: 

    The integer amount, in days, after which to remove legal hold.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`Backup.Client.exceptions.InvalidParameterValueException`

  
  *   :py:class:`Backup.Client.exceptions.InvalidResourceStateException`

  
  *   :py:class:`Backup.Client.exceptions.MissingParameterValueException`

  
  *   :py:class:`Backup.Client.exceptions.ServiceUnavailableException`

  
  *   :py:class:`Backup.Client.exceptions.ResourceNotFoundException`

  