:doc:`SecurityHub <../../securityhub>` / Client / update_standards_control

************************
update_standards_control
************************



.. py:method:: SecurityHub.Client.update_standards_control(**kwargs)

  

  Used to control whether an individual security standard control is enabled or disabled.

   

  Calls to this operation return a ``RESOURCE_NOT_FOUND_EXCEPTION`` error when the standard subscription for the control has ``StandardsControlsUpdatable`` value ``NOT_READY_FOR_UPDATES``.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/UpdateStandardsControl>`_  


  **Request Syntax**
  ::

    response = client.update_standards_control(
        StandardsControlArn='string',
        ControlStatus='ENABLED'|'DISABLED',
        DisabledReason='string'
    )
    
  :type StandardsControlArn: string
  :param StandardsControlArn: **[REQUIRED]** 

    The ARN of the security standard control to enable or disable.

    

  
  :type ControlStatus: string
  :param ControlStatus: 

    The updated status of the security standard control.

    

  
  :type DisabledReason: string
  :param DisabledReason: 

    A description of the reason why you are disabling a security standard control. If you are disabling a control, then this is required.

    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`SecurityHub.Client.exceptions.InternalException`

  
  *   :py:class:`SecurityHub.Client.exceptions.InvalidInputException`

  
  *   :py:class:`SecurityHub.Client.exceptions.InvalidAccessException`

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

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

  