AWS::SES::ConfigurationSetEventDestination DimensionConfiguration - AWS CloudFormation

AWS::SES::ConfigurationSetEventDestination DimensionConfiguration

Contains the dimension configuration to use when you publish email sending events to Amazon CloudWatch.

For information about publishing email sending events to Amazon CloudWatch, see the Amazon SES Developer Guide.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "DefaultDimensionValue" : String, "DimensionName" : String, "DimensionValueSource" : String }

Properties

DefaultDimensionValue

The default value of the dimension that is published to Amazon CloudWatch if you do not provide the value of the dimension when you send an email. The default value must meet the following requirements:

  • Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), dashes (-), at signs (@), or periods (.).

  • Contain 256 characters or fewer.

Required: Yes

Type: String

Pattern: ^[a-zA-Z0-9_-]{1,256}$

Minimum: 1

Maximum: 256

Update requires: No interruption

DimensionName

The name of an Amazon CloudWatch dimension associated with an email sending metric. The name must meet the following requirements:

  • Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), dashes (-), or colons (:).

  • Contain 256 characters or fewer.

Required: Yes

Type: String

Pattern: ^[a-zA-Z0-9_:-]{1,256}$

Minimum: 1

Maximum: 256

Update requires: No interruption

DimensionValueSource

The place where Amazon SES finds the value of a dimension to publish to Amazon CloudWatch. To use the message tags that you specify using an X-SES-MESSAGE-TAGS header or a parameter to the SendEmail/SendRawEmail API, specify messageTag. To use your own email headers, specify emailHeader. To put a custom tag on any link included in your email, specify linkTag.

Required: Yes

Type: String

Allowed values: messageTag | emailHeader | linkTag

Update requires: No interruption