Skip to content

Put Identity Policy

ses_put_identity_policy R Documentation

Adds or updates a sending authorization policy for the specified identity (an email address or a domain)

Description

Adds or updates a sending authorization policy for the specified identity (an email address or a domain).

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.

Usage

ses_put_identity_policy(Identity, PolicyName, Policy)

Arguments

Identity

[required] The identity to which that the policy applies. 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.

PolicyName

[required] The name of the policy.

The policy name cannot exceed 64 characters and can only include alphanumeric characters, dashes, and underscores.

Policy

[required] The text of the policy in JSON format. The policy cannot exceed 4 KB.

For information about the syntax of sending authorization policies, see the Amazon SES Developer Guide.

Value

An empty list.

Request syntax

svc$put_identity_policy(
  Identity = "string",
  PolicyName = "string",
  Policy = "string"
)

Examples

## Not run: 
# The following example adds a sending authorization policy to an
# identity:
svc$put_identity_policy(
  Identity = "example.com",
  Policy = "{"Version":"2008-10-17","Statement":[{"Sid":"stmt1469123904194"...",
  PolicyName = "MyPolicy"
)

## End(Not run)