SES / Client / delete_identity_policy

delete_identity_policy

SES.Client.delete_identity_policy(**kwargs)

Deletes the specified sending authorization policy for the given identity (an email address or a domain). This API returns successfully even if a policy with the specified name does not exist.

Note

This API is for the identity owner only. If you have not verified the identity, this API will return an error.

Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

See also: AWS API Documentation

Request Syntax

response = client.delete_identity_policy(
    Identity='string',
    PolicyName='string'
)

Parameters:

• Identity (string) –

  [REQUIRED]

  The identity that is associated with the policy that you want to delete. You can specify the identity by using its name or by using its Amazon Resource Name (ARN). Examples: user@example.com, example.com, arn:aws:ses:us-east-1:123456789012:identity/example.com.

  To successfully call this API, you must own the identity.

• PolicyName (string) –

  [REQUIRED]

  The name of the policy to be deleted.

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

• (dict) –

  An empty element returned on a successful request.

Examples

The following example deletes a sending authorization policy for an identity:

response = client.delete_identity_policy(
    Identity='user@example.com',
    PolicyName='MyPolicy',
)

print(response)

Expected Output:

{
    'ResponseMetadata': {
        '...': '...',
    },
}