GET

/detect/mitigationactions/executions

http://iot.{region}.amazonaws.com/detect/mitigationactions/executions

<p> Lists mitigation actions executions for a Device Defender ML Detect 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">ListDetectMitigationActionsExecutions</a> action.</p>

Access Token Required: API Key

Query Params

taskIdstring

The unique identifier of the task.

violationIdstring

The unique identifier of the violation.

thingNamestring

The name of the thing whose mitigation actions are listed.

startTimestring

A filter to limit results to those found after the specified time. You must specify either the startTime and endTime or the taskId, but not both.

endTimestring

The end of the time period for which ML Detect mitigation actions executions are returned.

maxResultsinteger

The maximum number of results to return at one time. The default is 25.

nextTokenstring

The token for the next set of results.

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/detect/mitigationactions/executions' \
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}