AWS::PinpointEmail::ConfigurationSetEventDestination DimensionConfiguration - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::PinpointEmail::ConfigurationSetEventDestination DimensionConfiguration

An array of objects that define the dimensions to use when you send email events to Amazon CloudWatch.

Syntax

To declare this entity in your Amazon 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 don't provide the value of the dimension when you send an email. This value has to meet the following criteria:

  • It can only contain ASCII letters (a–z, A–Z), numbers (0–9), underscores (_), or dashes (-).

  • It can contain no more than 256 characters.

Required: Yes

Type: String

Update requires: No interruption

DimensionName

The name of an Amazon CloudWatch dimension associated with an email sending metric. The name has to meet the following criteria:

  • It can only contain ASCII letters (a–z, A–Z), numbers (0–9), underscores (_), or dashes (-).

  • It can contain no more than 256 characters.

Required: Yes

Type: String

Update requires: No interruption

DimensionValueSource

The location where Amazon Pinpoint finds the value of a dimension to publish to Amazon CloudWatch. Acceptable values: MESSAGE_TAG, EMAIL_HEADER, and LINK_TAG.

If you want Amazon Pinpoint to use the message tags that you specify using an X-SES-MESSAGE-TAGS header or a parameter to the SendEmail API, choose MESSAGE_TAG. If you want Amazon Pinpoint to use your own email headers, choose EMAIL_HEADER. If you want Amazon Pinpoint to use tags that are specified in your links, choose LINK_TAG.

Required: Yes

Type: String

Update requires: No interruption