Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

PutConfigurationSetDeliveryOptions

Associate a configuration set with a dedicated IP pool. You can use dedicated IP pools to create groups of dedicated IP addresses for sending specific types of email.

Request Syntax


PUT /v2/email/configuration-sets/ConfigurationSetName/delivery-options HTTP/1.1
Content-type: application/json

{
   "MaxDeliverySeconds": number,
   "SendingPoolName": "string",
   "TlsPolicy": "string"
}

URI Request Parameters

The request uses the following URI parameters.

ConfigurationSetName

The name of the configuration set to associate with a dedicated IP pool.

Required: Yes

Request Body

The request accepts the following data in JSON format.

MaxDeliverySeconds

The maximum amount of time, in seconds, that Amazon SES API v2 will attempt delivery of email. If specified, the value must greater than or equal to 300 seconds (5 minutes) and less than or equal to 50400 seconds (840 minutes).

Type: Long

Valid Range: Minimum value of 300. Maximum value of 50400.

Required: No

SendingPoolName

The name of the dedicated IP pool to associate with the configuration set.

Type: String

Required: No

TlsPolicy

Specifies whether messages that use the configuration set are required to use Transport Layer Security (TLS). If the value is Require, messages are only delivered if a TLS connection can be established. If the value is Optional, messages can be delivered in plain text if a TLS connection can't be established.

Type: String

Valid Values: REQUIRE | OPTIONAL

Required: No

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 Errors.

BadRequestException

The input you provided is invalid.

HTTP Status Code: 400

NotFoundException

The resource you attempted to access doesn't exist.

HTTP Status Code: 404

TooManyRequestsException

Too many requests have been made to the operation.

HTTP Status Code: 429