View a markdown version of this page

PutAccountDeliveryAttributes - Amazon Simple Email Service

PutAccountDeliveryAttributes

Set the shared pool delivery mode for your Amazon SES account in the current AWS Region. The mode controls whether Amazon SES can deliver your email from shared IP addresses in other AWS Regions within the same AWS partition.

A change may take a few minutes to take effect. Messages that are already queued for delivery keep the mode that they were sent with.

Request Syntax

POST /v2/email/account/delivery HTTP/1.1 Content-type: application/json { "SharedPoolDeliveryMode": "string" }

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

SharedPoolDeliveryMode

The shared pool delivery mode for your Amazon SES account in the current AWS Region. This mode applies to email that you send from shared IP addresses. Can be one of the following:

  • GLOBAL – Amazon SES delivers from your sending Region first and, when it improves your deliverability, also uses Amazon SES shared IP addresses with established sending history in other AWS Regions within the same AWS partition.

  • REGIONAL – Amazon SES delivers your email only from shared IP addresses in your sending Region.

Type: String

Valid Values: GLOBAL | REGIONAL

Required: Yes

Response Syntax

HTTP/1.1 200

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

For information about the errors that are common to all actions, see Common Error Types.

BadRequestException

The input you provided is invalid.

HTTP Status Code: 400

TooManyRequestsException

Too many requests have been made to the operation.

HTTP Status Code: 429

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: