Skip to content

detach_security_profile

detach_security_profile(
    security_profile_name: SecurityProfileName,
    security_profile_target_arn: SecurityProfileTargetArn,
    *,
    config_overrides: Optional[IoTClientConfig] = None,
) -> DetachSecurityProfileResponse

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.

Disassociates a Device Defender security profile from a thing group or from this account.

Requires permission to access the DetachSecurityProfile action.

Parameters:

  • security_profile_name (SecurityProfileName) –

    The security profile that is detached.

  • security_profile_target_arn (SecurityProfileTargetArn) –

    The ARN of the thing group from which the security profile is detached.

Raises:

Source code in docs_src/capo_iot/_services/io_t.py
def detach_security_profile(
    self,
    security_profile_name: "capo_iot.types.security_profile_name.SecurityProfileName",
    security_profile_target_arn: "capo_iot.types.security_profile_target_arn.SecurityProfileTargetArn",
    *,
    config_overrides: Optional[IoTClientConfig] = None,
) -> (
    "capo_iot.types.detach_security_profile_response.DetachSecurityProfileResponse"
):
    """<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>Disassociates a Device Defender security profile from a thing group or from this account.</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">DetachSecurityProfile</a> action.</p>

    Args:
        security_profile_name: <p>The security profile that is detached.</p>
        security_profile_target_arn: <p>The ARN of the thing group from which the security profile is detached.</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.resource_not_found_exception.ResourceNotFoundException: <p>The specified resource does not exist.</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.detach_security_profile_request.DetachSecurityProfileRequest]",
    ) -> OperationResponse[
        "capo_iot.types.detach_security_profile_response.DetachSecurityProfileResponse"
    ]:
        import capo_iot._operations.aws_iot_service.detach_security_profile

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

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("DetachSecurityProfile")
    )
    input_: capo_iot.types.detach_security_profile_request.DetachSecurityProfileRequest = {
        "security_profile_name": security_profile_name,
        "security_profile_target_arn": security_profile_target_arn,
    }

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