SES / Client / get_identity_policies

get_identity_policies#

SES.Client.get_identity_policies(**kwargs)#

Returns the requested sending authorization policies for the given identity (an email address or a domain). The policies are returned as a map of policy names to policy contents. You can retrieve a maximum of 20 policies at a time.

Note

This operation is for the identity owner only. If you have not verified the identity, it returns 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.get_identity_policies(
    Identity='string',
    PolicyNames=[
        'string',
    ]
)
Parameters:
  • Identity (string) –

    [REQUIRED]

    The identity for which the policies are retrieved. You can specify an 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 operation, you must own the identity.

  • PolicyNames (list) –

    [REQUIRED]

    A list of the names of policies to be retrieved. You can retrieve a maximum of 20 policies at a time. If you do not know the names of the policies that are attached to the identity, you can use ListIdentityPolicies.

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'Policies': {
        'string': 'string'
    }
}

Response Structure

  • (dict) –

    Represents the requested sending authorization policies.

    • Policies (dict) –

      A map of policy names to policies.

      • (string) –

        • (string) –

Examples

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

response = client.get_identity_policies(
    Identity='example.com',
    PolicyNames=[
        'MyPolicy',
    ],
)

print(response)

Expected Output:

{
    'Policies': {
        'MyPolicy': '{"Version":"2008-10-17","Statement":[{"Sid":"stmt1469123904194","Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789012:root"},"Action":["ses:SendEmail","ses:SendRawEmail"],"Resource":"arn:aws:ses:us-east-1:EXAMPLE65304:identity/example.com"}]}',
    },
    'ResponseMetadata': {
        '...': '...',
    },
}