:doc:`AuditManager <../../auditmanager>` / Client / deregister_account

******************
deregister_account
******************



.. py:method:: AuditManager.Client.deregister_account()

  

  Deregisters an account in Audit Manager.

   

  .. note::

    

    Before you deregister, you can use the `UpdateSettings <https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_UpdateSettings.html>`__ API operation to set your preferred data retention policy. By default, Audit Manager retains your data. If you want to delete your data, you can use the ``DeregistrationPolicy`` attribute to request the deletion of your data.

     

    For more information about data retention, see `Data Protection <https://docs.aws.amazon.com/audit-manager/latest/userguide/data-protection.html>`__ in the *Audit Manager User Guide*.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/DeregisterAccount>`_  


  **Request Syntax**
  ::

    response = client.deregister_account()
    
    
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'status': 'ACTIVE'|'INACTIVE'|'PENDING_ACTIVATION'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **status** *(string) --* 

        The registration status of the account.

        
  
  **Exceptions**
  
  *   :py:class:`AuditManager.Client.exceptions.ValidationException`

  
  *   :py:class:`AuditManager.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`AuditManager.Client.exceptions.InternalServerException`

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

  