:doc:`IoT <../../iot>` / Client / update_scheduled_audit

**********************
update_scheduled_audit
**********************



.. py:method:: IoT.Client.update_scheduled_audit(**kwargs)

  

  Updates a scheduled audit, including which checks are performed and how often the audit takes place.

   

  Requires permission to access the `UpdateScheduledAudit <https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions>`__ action.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iot-2015-05-28/UpdateScheduledAudit>`_  


  **Request Syntax**
  ::

    response = client.update_scheduled_audit(
        frequency='DAILY'|'WEEKLY'|'BIWEEKLY'|'MONTHLY',
        dayOfMonth='string',
        dayOfWeek='SUN'|'MON'|'TUE'|'WED'|'THU'|'FRI'|'SAT',
        targetCheckNames=[
            'string',
        ],
        scheduledAuditName='string'
    )
    
  :type frequency: string
  :param frequency: 

    How often the scheduled audit takes place, either ``DAILY``, ``WEEKLY``, ``BIWEEKLY``, or ``MONTHLY``. The start time of each audit is determined by the system.

    

  
  :type dayOfMonth: string
  :param dayOfMonth: 

    The day of the month on which the scheduled audit takes place. This can be ``1`` through ``31`` or ``LAST``. This field is required if the ``frequency`` parameter is set to ``MONTHLY``. If days 29-31 are specified, and the month does not have that many days, the audit takes place on the "LAST" day of the month.

    

  
  :type dayOfWeek: string
  :param dayOfWeek: 

    The day of the week on which the scheduled audit takes place. This can be one of ``SUN``, ``MON``, ``TUE``, ``WED``, ``THU``, ``FRI``, or ``SAT``. This field is required if the "frequency" parameter is set to ``WEEKLY`` or ``BIWEEKLY``.

    

  
  :type targetCheckNames: list
  :param targetCheckNames: 

    Which checks are performed during the scheduled audit. Checks must be enabled for your account. (Use ``DescribeAccountAuditConfiguration`` to see the list of all checks, including those that are enabled or use ``UpdateAccountAuditConfiguration`` to select which checks are enabled.)

    

  
    - *(string) --* 

      An audit check name. Checks must be enabled for your account. (Use ``DescribeAccountAuditConfiguration`` to see the list of all checks, including those that are enabled or use ``UpdateAccountAuditConfiguration`` to select which checks are enabled.)

      

    

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

    The name of the scheduled audit. (Max. 128 chars)

    

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

    
    ::

      {
          'scheduledAuditArn': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **scheduledAuditArn** *(string) --* 

        The ARN of the scheduled audit.

        
  
  **Exceptions**
  
  *   :py:class:`IoT.Client.exceptions.InvalidRequestException`

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

  
  *   :py:class:`IoT.Client.exceptions.ThrottlingException`

  
  *   :py:class:`IoT.Client.exceptions.InternalFailureException`

  