HEX
Server: Apache/2.4.41 (Ubuntu)
System: Linux ip-172-31-42-149 5.15.0-1084-aws #91~20.04.1-Ubuntu SMP Fri May 2 07:00:04 UTC 2025 aarch64
User: ubuntu (1000)
PHP: 7.4.33
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare,
Upload Files
File: //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*.