Skip to content
v2.277.0

DimensionConfigurationProperty Struct ​

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

Example ​

ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_pinpointemail as pinpointemail } from 'aws-cdk-lib';
const dimensionConfigurationProperty: pinpointemail.CfnConfigurationSetEventDestination.DimensionConfigurationProperty = {
  defaultDimensionValue: 'defaultDimensionValue',
  dimensionName: 'dimensionName',
  dimensionValueSource: 'dimensionValueSource',
};
python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_pinpointemail as pinpointemail

dimension_configuration_property = pinpointemail.CfnConfigurationSetEventDestination.DimensionConfigurationProperty(
    default_dimension_value="defaultDimensionValue",
    dimension_name="dimensionName",
    dimension_value_source="dimensionValueSource"
)
java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.pinpointemail.*;

DimensionConfigurationProperty dimensionConfigurationProperty = DimensionConfigurationProperty.builder()
        .defaultDimensionValue("defaultDimensionValue")
        .dimensionName("dimensionName")
        .dimensionValueSource("dimensionValueSource")
        .build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.PinpointEmail;

var dimensionConfigurationProperty = new DimensionConfigurationProperty {
    DefaultDimensionValue = "defaultDimensionValue",
    DimensionName = "dimensionName",
    DimensionValueSource = "dimensionValueSource"
};
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import "github.com/aws/aws-cdk-go/awscdk"

dimensionConfigurationProperty := &DimensionConfigurationProperty{
	DefaultDimensionValue: jsii.String("defaultDimensionValue"),
	DimensionName: jsii.String("dimensionName"),
	DimensionValueSource: jsii.String("dimensionValueSource"),
}

Properties ​

defaultDimensionValuestringdefault_dimension_valuestrdefaultDimensionValueStringDefaultDimensionValuestringDefaultDimensionValue*stringrequired#
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.
dimensionNamestringdimension_namestrdimensionNameStringDimensionNamestringDimensionName*stringrequired#
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.
dimensionValueSourcestringdimension_value_sourcestrdimensionValueSourceStringDimensionValueSourcestringDimensionValueSource*stringrequired#
The location where Amazon Pinpoint finds the value of a dimension to publish to Amazon CloudWatch.
notes

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 .