GET

/active-violations

http://iot.{region}.amazonaws.com/active-violations

<p>Lists the active violations for a given Device Defender security profile.</p> <p>Requires permission to access the <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions">ListActiveViolations</a> action.</p>

Access Token Required: API Key

Query Params

thingNamestring

The name of the thing whose active violations are listed.

securityProfileNamestring

The name of the Device Defender security profile for which violations are listed.

behaviorCriteriaTypestring

The criteria for a behavior.

Allowed:

listSuppressedAlertsboolean

A list of all suppressed alerts.

verificationStatestring

The verification state of the violation (detect alarm).

Allowed:

nextTokenstring

The token for the next set of results.

maxResultsinteger

The maximum number of results to return at one time.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://iot.{region}.amazonaws.com/active-violations' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}