IoT / Client / delete_policy

delete_policy#

IoT.Client.delete_policy(**kwargs)#

Deletes the specified policy.

A policy cannot be deleted if it has non-default versions or it is attached to any certificate.

To delete a policy, use the DeletePolicyVersion action to delete all non-default versions of the policy; use the DetachPolicy action to detach the policy from any certificate; and then use the DeletePolicy action to delete the policy.

When a policy is deleted using DeletePolicy, its default version is deleted with it.

Note

Because of the distributed nature of Amazon Web Services, it can take up to five minutes after a policy is detached before it’s ready to be deleted.

Requires permission to access the DeletePolicy action.

Request Syntax

response = client.delete_policy(
    policyName='string'
)

Parameters:

policyName (string) –

[REQUIRED]

The name of the policy to delete.

Returns:

None

Exceptions

IoT.Client.exceptions.DeleteConflictException
IoT.Client.exceptions.ResourceNotFoundException
IoT.Client.exceptions.InvalidRequestException
IoT.Client.exceptions.ThrottlingException
IoT.Client.exceptions.UnauthorizedException
IoT.Client.exceptions.ServiceUnavailableException
IoT.Client.exceptions.InternalFailureException