:doc:`ResourceGroups <../../resource-groups>` / Client / update_account_settings

***********************
update_account_settings
***********************



.. py:method:: ResourceGroups.Client.update_account_settings(**kwargs)

  

  Turns on or turns off optional features in Resource Groups.

   

  The preceding example shows that the request to turn on group lifecycle events is ``IN_PROGRESS``. You can call the  GetAccountSettings operation to check for completion by looking for ``GroupLifecycleEventsStatus`` to change to ``ACTIVE``.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/UpdateAccountSettings>`_  


  **Request Syntax**
  ::

    response = client.update_account_settings(
        GroupLifecycleEventsDesiredStatus='ACTIVE'|'INACTIVE'
    )
    
  :type GroupLifecycleEventsDesiredStatus: string
  :param GroupLifecycleEventsDesiredStatus: 

    Specifies whether you want to turn `group lifecycle events <https://docs.aws.amazon.com/ARG/latest/userguide/monitor-groups.html>`__ on or off.

     

    You can't turn on group lifecycle events if your resource groups quota is greater than 2,000.

    

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

    
    ::

      {
          'AccountSettings': {
              'GroupLifecycleEventsDesiredStatus': 'ACTIVE'|'INACTIVE',
              'GroupLifecycleEventsStatus': 'ACTIVE'|'INACTIVE'|'IN_PROGRESS'|'ERROR',
              'GroupLifecycleEventsStatusMessage': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **AccountSettings** *(dict) --* 

        A structure that displays the status of the optional features in the account.

        
        

        - **GroupLifecycleEventsDesiredStatus** *(string) --* 

          The desired target status of the group lifecycle events feature. If

          
        

        - **GroupLifecycleEventsStatus** *(string) --* 

          The current status of the group lifecycle events feature.

          
        

        - **GroupLifecycleEventsStatusMessage** *(string) --* 

          The text of any error message occurs during an attempt to turn group lifecycle events on or off.

          
    
  
  **Exceptions**
  
  *   :py:class:`ResourceGroups.Client.exceptions.BadRequestException`

  
  *   :py:class:`ResourceGroups.Client.exceptions.ForbiddenException`

  
  *   :py:class:`ResourceGroups.Client.exceptions.MethodNotAllowedException`

  
  *   :py:class:`ResourceGroups.Client.exceptions.TooManyRequestsException`

  
  *   :py:class:`ResourceGroups.Client.exceptions.InternalServerErrorException`

  