---
title: "PUT /logging"
method: PUT
path: "/logging"
---

# PUT /logging

`PUT /logging`

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.

## Request body

- object
  - `loggingOptions` object, required — The values of the AWS IoT Events logging options.
    - `roleArn` string — The ARN of the role that grants permission to AWS IoT Events to perform logging.
    - `level` 'ERROR' | 'INFO' | 'DEBUG' — The logging level.
    - `enabled` boolean — If TRUE, logging is enabled for AWS IoT Events.
    - `detectorDebugOptions` DetectorDebugOption[] — Information that identifies those detector models and their 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).

## Response `200`

Success

## Other responses

- `480` — InvalidRequestException
- `481` — ThrottlingException
- `482` — InternalFailureException
- `483` — ServiceUnavailableException
- `484` — UnsupportedOperationException
- `485` — ResourceInUseException

---

[API](https://skmtc.net/aws/apis/iotevents.md) · [All operations](https://skmtc.net/aws/apis/iotevents/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iotevents/versions/d3ae7b052b1d/schema)