AWS::PinpointEmail::Identity - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::PinpointEmail::Identity

指定用于通过 Amazon Pinpoint 发送电子邮件的身份。在 Amazon Pinpoint 中,身份 是发送电子邮件时使用的电子邮件地址或域。在您使用 Amazon Pinpoint 从身份发送电子邮件之前,您首先必须验证它。通过验证身份,您可以证明您是地址或域的拥有者,并且您已向 Amazon Pinpoint 授予从该身份发送电子邮件的权限。

在验证电子邮件地址时,Amazon Pinpoint 会向该地址发送一封电子邮件。您只要转至验证邮件中的链接即可验证您的电子邮件地址。

验证域时,此操作会提供一组 DKIM 令牌,可以将这些令牌转换为 CNAME 令牌。将这些 CNAME 令牌添加到域的 DNS 配置中。当 Amazon Pinpoint 在您的域的 DNS 配置中检测到这些记录时,将验证您的域。完成域验证过程通常需要约 72 小时。

重要

在使用 CloudFormation 指定身份时,CloudFormation 可能表示已成功创建身份。但是,您必须先验证身份,然后才能使用它发送电子邮件。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::PinpointEmail::Identity", "Properties" : { "DkimSigningEnabled" : Boolean, "FeedbackForwardingEnabled" : Boolean, "MailFromAttributes" : MailFromAttributes, "Name" : String, "Tags" : [ Tags, ... ] } }

YAML

Type: AWS::PinpointEmail::Identity Properties: DkimSigningEnabled: Boolean FeedbackForwardingEnabled: Boolean MailFromAttributes: MailFromAttributes Name: String Tags: - Tags

属性

DkimSigningEnabled

对于域身份,此属性用于启用或禁用域的域名密钥识别邮件 (DKIM) 签名。

如果值为 true,则同时使用域的 DKIM 密钥和 amazonses.com 域的密钥对从域发送的邮件进行签名。如果值为 false,则仅使用 amazonses.com 域的 DKIM 密钥对发送的邮件进行签名。

必需:否

类型:布尔值

Update requires: No interruption

FeedbackForwardingEnabled

用于为身份启用或禁用反馈转发。此设置确定在使用身份发送导致退回或投诉事件的电子邮件时会发生什么情况。

在启用反馈转发时,Amazon Pinpoint 会在发生退回或投诉事件时向您发送电子邮件通知。Amazon Pinpoint 将此通知发送到您在原始电子邮件的退回路径标头中指定的地址。

在禁用反馈转发时,Amazon Pinpoint 会通过其他机制发送通知,例如通知 Amazon SNS 主题。您需要有一种跟踪退回邮件和投诉的方法。如果您尚未设置其他机制来接收退回邮件或投诉通知,则 Amazon Pinpoint 会在发生这些事件时发送电子邮件通知(即使此设置已禁用)。

必需:否

类型:布尔值

Update requires: No interruption

MailFromAttributes

用于为电子邮件身份启用或禁用自定义发件人域配置

必需:否

类型MailFromAttributes

Update requires: No interruption

Name

身份的地址或域,例如 sender@example.comexample.co.uk

必需:是

类型:字符串

Update requires: Replacement

Tags

一个对象,定义要与电子邮件身份关联的标签(键和值)。

必需:否

类型标签列表

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回 资源名称。例如:

{ "Ref": "myEmailIdentity" }

对于 Amazon Pinpoint 身份 myEmailIdentity,Ref 返回身份的名称(电子邮件地址或域名)。

For more information about using the Ref function, see Ref.

Fn::GetAtt

Fn::GetAtt 内部函数返回此类型的一个指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 内部函数的更多信息,请参阅 Fn::GetAtt

IdentityDNSRecordName1

您必须添加到域的 DNS 配置的第一个令牌的主机名。

有关更多信息,请参阅《Amazon Pinpoint 用户指南》中的验证域

IdentityDNSRecordName2

您必须添加到域的 DNS 配置的第二个令牌的主机名。

IdentityDNSRecordName3

您必须添加到域的 DNS 配置的第三个令牌的主机名。

IdentityDNSRecordValue1

您必须添加到域的 DNS 配置的第一个令牌的记录值。

IdentityDNSRecordValue2

您必须添加到域的 DNS 配置的第二个令牌的记录值。

IdentityDNSRecordValue3

您必须添加到域的 DNS 配置的第三个令牌的记录值。

另请参阅