:doc:`IoTEvents <../../iotevents>` / Client / put_logging_options

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



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

  

  Sets or updates the AWS IoT Events logging options.

   

  If you update the value of any ``loggingOptions`` field, it takes up to one minute for the change to take effect. 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/iotevents-2018-07-27/PutLoggingOptions>`_  


  **Request Syntax**
  ::

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

    The new values of the AWS IoT Events logging options.

    

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

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

      

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

      The logging level.

      

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

      If TRUE, logging is enabled for AWS IoT Events.

      

    
    - **detectorDebugOptions** *(list) --* 

      Information that identifies those detector models and their detectors (instances) for which the logging level is given.

      

    
      - *(dict) --* 

        The detector model and the specific detectors (instances) for which the logging level is given.

        

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

          The name of the detector model.

          

        
        - **keyValue** *(string) --* 

          The value of the input attribute key used to create the detector (the instance of the detector model).

          

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

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

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

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

  
  *   :py:class:`IoTEvents.Client.exceptions.UnsupportedOperationException`

  
  *   :py:class:`IoTEvents.Client.exceptions.ResourceInUseException`

  