list_detect_mitigation_actions_executions ¶

def list_detect_mitigation_actions_executions(
    self,
    *,
    config_overrides: Optional[IoTClientConfig] = None,
    task_id: Optional[
        "capo_iot.types.mitigation_actions_task_id.MitigationActionsTaskId"
    ] = None,
    violation_id: Optional["capo_iot.types.violation_id.ViolationId"] = None,
    thing_name: Optional[
        "capo_iot.types.device_defender_thing_name.DeviceDefenderThingName"
    ] = None,
    start_time: Optional["capo_iot.types.timestamp.Timestamp"] = None,
    end_time: Optional["capo_iot.types.timestamp.Timestamp"] = None,
    max_results: Optional["capo_iot.types.max_results.MaxResults"] = None,
    next_token: Optional["capo_iot.types.next_token.NextToken"] = None,
) -> "capo_iot.types.list_detect_mitigation_actions_executions_response.ListDetectMitigationActionsExecutionsResponse":
    """<note> <p>The IoT Device Defender detect feature will no longer be available to new customers starting August 31, 2026. If you would like to use the detect feature, sign up prior to August 31, 2026. To learn about alternatives to IoT Device Defender detect, see IoT Device Defender detect feature availability change in the IoT Device Defender Developer Guide. There is no change to IoT Device Defender audit availability.</p> </note> <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>

    Args:
        task_id: <p> The unique identifier of the task. </p>
        violation_id: <p> The unique identifier of the violation. </p>
        thing_name: <p> The name of the thing whose mitigation actions are listed. </p>
        start_time: <p> 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. </p>
        end_time: <p> The end of the time period for which ML Detect mitigation actions executions are returned. </p>
        max_results: <p> The maximum number of results to return at one time. The default is 25. </p>
        next_token: <p> The token for the next set of results. </p>

    Raises:
        capo_iot.errors.internal_failure_exception.InternalFailureException: <p>An unexpected error has occurred.</p>
        capo_iot.errors.invalid_request_exception.InvalidRequestException: <p>The request is not valid.</p>
        capo_iot.errors.throttling_exception.ThrottlingException: <p>The rate exceeds the limit.</p>
        capo_iot.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_iot.types.list_detect_mitigation_actions_executions_request.ListDetectMitigationActionsExecutionsRequest]",
    ) -> OperationResponse[
        "capo_iot.types.list_detect_mitigation_actions_executions_response.ListDetectMitigationActionsExecutionsResponse"
    ]:
        import capo_iot._operations.aws_iot_service.list_detect_mitigation_actions_executions

        output, http_response = (
            capo_iot._operations.aws_iot_service.list_detect_mitigation_actions_executions.list_detect_mitigation_actions_executions(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListDetectMitigationActionsExecutions")
    )
    input_: capo_iot.types.list_detect_mitigation_actions_executions_request.ListDetectMitigationActionsExecutionsRequest = {}
    if task_id is not None:
        input_["task_id"] = task_id
    if violation_id is not None:
        input_["violation_id"] = violation_id
    if thing_name is not None:
        input_["thing_name"] = thing_name
    if start_time is not None:
        input_["start_time"] = start_time
    if end_time is not None:
        input_["end_time"] = end_time
    if max_results is not None:
        input_["max_results"] = max_results
    if next_token is not None:
        input_["next_token"] = next_token

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output