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.
Deletes a Device Defender security profile.
Requires permission to access the DeleteSecurityProfile action.
Parameters:
-
security_profile_name
(SecurityProfileName)
–
The name of the security profile to be deleted.
-
expected_version
(Optional[OptionalVersion], default:
None
)
–
The expected version of the security profile. A new version is generated whenever the security profile is updated. If you specify a value that is different from the actual version, a VersionConflictException is thrown.
Raises:
Source code in docs_src/capo_iot/_services/async_io_t.py
| async def delete_security_profile(
self,
security_profile_name: "capo_iot.types.security_profile_name.SecurityProfileName",
*,
config_overrides: Optional[AsyncIoTClientConfig] = None,
expected_version: Optional[
"capo_iot.types.optional_version.OptionalVersion"
] = None,
) -> (
"capo_iot.types.delete_security_profile_response.DeleteSecurityProfileResponse"
):
"""<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>Deletes a Device Defender 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">DeleteSecurityProfile</a> action.</p>
Args:
security_profile_name: <p>The name of the security profile to be deleted.</p>
expected_version: <p>The expected version of the security profile. A new version is generated whenever the security profile is updated. If you specify a value that is different from the actual version, a <code>VersionConflictException</code> is thrown.</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.version_conflict_exception.VersionConflictException: <p>An exception thrown when the version of an entity specified with the <code>expectedVersion</code> parameter does not match the latest version in the system.</p>
capo_iot.errors.UnknownServiceError: The service returned an error code this client does not model.
"""
async def _handler(
req: "AsyncOperationRequest[capo_iot.types.delete_security_profile_request.DeleteSecurityProfileRequest]",
) -> AsyncOperationResponse[
"capo_iot.types.delete_security_profile_response.DeleteSecurityProfileResponse"
]:
import capo_iot._operations.aws_iot_service.delete_security_profile
(
output,
http_response,
) = await capo_iot._operations.aws_iot_service.delete_security_profile.async_delete_security_profile(
req.options, req.input
)
return AsyncOperationResponse(output=output, response=http_response)
interceptors_, options_ = self.operation_options(
config_overrides, OperationLogging("DeleteSecurityProfile")
)
input_: capo_iot.types.delete_security_profile_request.DeleteSecurityProfileRequest = {
"security_profile_name": security_profile_name
}
if expected_version is not None:
input_["expected_version"] = expected_version
response = await aexecute_pipeline(
AsyncOperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
await response.response.aclose()
return response.output
|