HEX
Server: Apache
System: Linux pdx1-shared-a1-38 6.6.104-grsec-jammy+ #3 SMP Tue Sep 16 00:28:11 UTC 2025 x86_64
User: mmickelson (3396398)
PHP: 8.1.31
Disabled: NONE
Upload Files
File: //usr/lib/python3/dist-packages/awscli/examples/iot/describe-audit-mitigation-actions-task.rst
**To show the details of an audit mitigation actions task**

The following ``describe-audit-mitigation-actions-task`` example shows the details for the specified task, where the ``ResetPolicyVersionAction`` was applied to a finding. The results include when the task started and ended, how many findings were targeted (and the outcome), and the definition of the action that is applied as part of this task. ::

    aws iot describe-audit-mitigation-actions-task \
        --task-id ResetPolicyTask01

Output::

    {
        "taskStatus": "COMPLETED",
        "startTime": "2019-12-10T15:13:19.457000-08:00",
        "endTime": "2019-12-10T15:13:19.947000-08:00",
        "taskStatistics": {
            "IOT_POLICY_OVERLY_PERMISSIVE_CHECK": {
                "totalFindingsCount": 1,
                "failedFindingsCount": 0,
                "succeededFindingsCount": 1,
                "skippedFindingsCount": 0,
                "canceledFindingsCount": 0
            }
        },
        "target": {
            "findingIds": [
                "ef4826b8-e55a-44b9-b460-5c485355371b"
            ]
        },
        "auditCheckToActionsMapping": {
            "IOT_POLICY_OVERLY_PERMISSIVE_CHECK": [
                "ResetPolicyVersionAction"
            ]
        },
        "actionsDefinition": [
            {
                "name": "ResetPolicyVersionAction",
                "id": "1ea0b415-bef1-4a01-bd13-72fb63c59afb",
                "roleArn": "arn:aws:iam::123456789012:role/service-role/ReplacePolicyVersionRole",
                "actionParams": {
                    "replaceDefaultPolicyVersionParams": {
                        "templateName": "BLANK_POLICY"
                    }
                }
            }
        ]
    }

For more information, see `DescribeAuditMitigationActionsTask (Mitigation Action Commands) <https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-DescribeAuditMitigationActionsTask>`__ in the *AWS IoT Developer Guide*.