Skip to content

delete_detector

delete_detector(
    detector_id: DetectorId, *, config_overrides: Optional[GuardDutyClientConfig] = None
) -> DeleteDetectorResponse

Deletes an Amazon GuardDuty detector that is specified by the detector ID.

Parameters:

  • detector_id (DetectorId) –

    The unique ID of the detector that you want to delete.

    To find the detectorId in the current Region, see the Settings page in the GuardDuty console, or run the ListDetectors API.

Raises:

Source code in docs_src/capo_guardduty/_services/guard_duty.py
def delete_detector(
    self,
    detector_id: "capo_guardduty.types.detector_id.DetectorId",
    *,
    config_overrides: Optional[GuardDutyClientConfig] = None,
) -> "capo_guardduty.types.delete_detector_response.DeleteDetectorResponse":
    """<p>Deletes an Amazon GuardDuty detector that is specified by the detector ID.</p>

    Args:
        detector_id: <p>The unique ID of the detector that you want to delete.</p> <p>To find the <code>detectorId</code> in the current Region, see the Settings page in the GuardDuty console, or run the <a href="https://docs.aws.amazon.com/guardduty/latest/APIReference/API_ListDetectors.html">ListDetectors</a> API.</p>

    Raises:
        capo_guardduty.errors.bad_request_exception.BadRequestException: <p>A bad request exception object.</p>
        capo_guardduty.errors.internal_server_error_exception.InternalServerErrorException: <p>An internal server error exception object.</p>
        capo_guardduty.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_guardduty.types.delete_detector_request.DeleteDetectorRequest]",
    ) -> OperationResponse[
        "capo_guardduty.types.delete_detector_response.DeleteDetectorResponse"
    ]:
        import capo_guardduty._operations.guard_duty_api_service.delete_detector

        output, http_response = (
            capo_guardduty._operations.guard_duty_api_service.delete_detector.delete_detector(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("DeleteDetector")
    )
    input_: capo_guardduty.types.delete_detector_request.DeleteDetectorRequest = {
        "detector_id": detector_id
    }

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