:doc:`IoTAnalytics <../../iotanalytics>` / Client / put_logging_options

*******************
put_logging_options
*******************



.. py:method:: IoTAnalytics.Client.put_logging_options(**kwargs)

  

  Sets or updates the IoT Analytics logging options.

   

  If you update the value of any ``loggingOptions`` field, it takes up to one minute for the change to take effect. Also, if you change the policy attached to the role you specified in the ``roleArn`` field (for example, to correct an invalid policy), it takes up to five minutes for that change to take effect.

  

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


  **Request Syntax**
  ::

    response = client.put_logging_options(
        loggingOptions={
            'roleArn': 'string',
            'level': 'ERROR',
            'enabled': True|False
        }
    )
    
  :type loggingOptions: dict
  :param loggingOptions: **[REQUIRED]** 

    The new values of the IoT Analytics logging options.

    

  
    - **roleArn** *(string) --* **[REQUIRED]** 

      The ARN of the role that grants permission to IoT Analytics to perform logging.

      

    
    - **level** *(string) --* **[REQUIRED]** 

      The logging level. Currently, only ERROR is supported.

      

    
    - **enabled** *(boolean) --* **[REQUIRED]** 

      If true, logging is enabled for IoT Analytics.

      

    
  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`IoTAnalytics.Client.exceptions.InvalidRequestException`

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

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

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

  