本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# AWS 最终用户消息 SMS 中的事件目的地
*事件目的地*是发送短信和语音事件的地点（例如 CloudWatch 群组、Amazon Data Firehose 直播或 Amazon SNS 主题）。要使用事件目标，请先创建目标，然后将其与 [AWS 终端用户消息发送 SMS 服务中的配置集](configuration-sets.md)关联。您可以将最多 5 个事件目标与一个配置集相关联。当您发送消息时，您对该 API 的调用可以包括对配置集的引用。
运营商生成的事件或送达回执（DLR）可能需要长达 72 小时才能接收，因此不应依赖这些事件来判断出站消息是否存在延迟。72 小时后，如果 AWS 最终用户消息短信未收到运营商的最终事件，则该服务将自动返回 UNKNOWN，`messageStatus`因为我们不知道该消息发生了什么。
**先决条件**
您需要已创建好配置集才能将事件目标与之关联，请参阅 [AWS 终端用户消息发送 SMS 服务中的配置集](configuration-sets.md)。
**Topics**
+ [事件类型](configuration-sets-event-types.md)
+ [事件数据示例](configuration-sets-event-format.md)
+ [设置亚马逊 CloudWatch 活动目的地](configuration-sets-cloud-watch.md)
+ [设置 Amazon Data Firehose 事件目标](configuration-sets-kinesis.md)
+ [设置 Amazon SNS 事件目标](configuration-sets-sns.md)
# 短信、彩信和语音的事件类型
使用事件目标的最简单方法是将所有短信、彩信和语音事件发送到单个目标。但是，您可以配置事件目标，以将特定类型的事件发送到不同目标。例如，您可以将所有与送达相关的事件发送到 Firehose 进行存储，而将所有失败事件发送到 Amazon SNS 主题，以便在发生时收到通知。您还可以将短信事件和语音事件发送到不同的地点。
您可以配置事件目标以发送以下类型的事件：
**短信、彩信和语音事件**
+ **ALL** – 将所有短信、彩信和语音事件发送到指定目标。
**短信事件**
+ **TEXT\$1ALL** – 将所有短信事件发送到指定目标。
+ **TEXT\$1DELIVERED（已送达）**– 将所有短信送达事件发送到指定目标。根据目标国家/地区的不同，**TEXT\$1DELIVERED** 和 **TEXT\$1SUCCESSFUL** 事件可互换使用。
+ **TEXT\$1SUCCESSFUL（成功）**– 当消息被收件人的运营商接受时，就会发生成功事件。根据目标国家/地区的不同，**TEXT\$1DELIVERED** 和 **TEXT\$1SUCCESSFUL** 事件可互换使用。
+ **TEXT\$1QUEUED（已排队）**– 当消息排队等待传送但尚未送达时，就会发生排队事件。
+ **TEXT\$1PENDING（待处理）**– 当消息正在传递过程中但尚未送达（或未能送达）时，就会发生待处理事件。
+ **TEXT\$1BLOCKED（已屏蔽）**– 当收件人的设备或运营商屏蔽发送给该收件人的消息时，就会发生屏蔽事件。
+ **TEXT\$1TTL\$1EXPIRED（TTL 已过期）**– 当传送消息所需的时间超过您在发送消息时指定的 `TTL` 值时，就会发生 TTL 过期事件。
+ **TEXT\$1CARRIER\$1UNREACHABLE（无法联系运营商）**– 当消息收件人的运营商网络发生暂时性错误时，就会发生无法联系运营商事件。
+ **TEXT\$1INVALID（短信无效）**– 当目标电话号码无效时，就会发生无效事件。
+ **TEXT\$1INVALID\$1MESSAGE（消息无效）**– 当短信的正文无效且无法传送时，就会发生无效消息事件。
+ **TEXT\$1CARRIER\$1BLOCKED（运营商被阻止）**– 当收件人的运营商阻止消息传送时，就会发生运营商被阻止事件。当运营商将消息识别为恶意消息（例如，其中包含与钓鱼骗术相关的信息）或滥用消息（例如，消息被怀疑是未经请求的或违禁的）时，就会发生这种情况。
+ **TEXT\$1UNREACHABLE（无法联系）**– 当收件人的设备不可用时，就会发生无法联系事件。如果设备未连接到移动网络或已关机，则可能会发生这种情况。
+ **TEXT\$1SPAM（垃圾消息）**– 当收件人的运营商识别出消息中包含未经请求的商业内容并阻止传送消息时，就会发生垃圾消息事件。
+ **TEXT\$1UNKNOWN（未知）**– 当消息由于其他事件类型未涵盖的原因而未能传送时，就会发生未知事件。未知错误可能是暂时的，也可能是永久性的。
+ **TEXT\$1PROTECT\$1BLOCKED（保护已阻止）**– 保护配置阻止的消息。
**语音事件**
+ **VOICE\$1ALL** – 将所有语音事件发送到指定目标。
+ **VOICE\$1COMPLETED（已完成）**– 向接收者播放音频消息时，就会发生已完成事件。此状态并不一定意味着消息已送达人类收件人。例如，它可能表示留言已传送到语音信箱系统。
+ **VOICE\$1ANSWERED（已应答）**– 当收件人接听电话时，就会发生已应答事件。
+ **VOICE\$1INITIATED（已启动）**– 每当有语音消息发起时，都将事件发送到指定目标。
+ **VOICE\$1TTL\$1EXPIRED（TTL 已过期）**– 当传送消息所需的时间超过您在发送消息时指定的 `TTL` 值时，就会发生 TTL 过期事件。
+ **VOICE\$1BUSY（占线）**– 当收件人的电话线占线时，就会发生忙线事件。
+ **VOICE\$1NO\$1ANSWER（无应答）**– 拨打了电话但收件人（或其语音信箱系统）从不应答时，就会发生无应答事件。
+ **VOICE\$1RINGING（响铃）**– 拨号完成后、收件人接听前发生的响铃事件。
+ **VOICE\$1FAILED（失败）**– 当消息传送失败时，就会发生失败事件。
**彩信事件**
+ **MEDIA\$1ALL** – 将所有彩信事件发送到指定目标。
+ **MEDIA\$1PENDING（待处理）**– 当消息正在传递过程中但尚未送达（或未能送达）时，就会发生待处理事件。
+ **MEDIA\$1QUEUED（已排队）**– 当消息排队等待传送但尚未送达时，就会发生排队事件。
+ **MEDIA\$1SUCCESSFUL（成功）**– 当消息被收件人的运营商接受时，就会发生成功事件。
+ **MEDIA\$1DELIVERED（已送达）**– 将所有彩信送达事件发送到指定目标。
+ **MEDIA\$1INVALID（彩信无效）**– 当目标电话号码无效时，就会发生无效事件。
+ **MEDIA\$1INVALID\$1MESSAGE（消息无效）**– 当彩信的正文无效且无法传送时，就会发生无效消息事件。
+ **MEDIA\$1UNREACHABLE（无法联系）**– 当收件人的设备不可用时，就会发生无法联系事件。如果设备未连接到移动网络或已关机，则可能会发生这种情况。
+ **MEDIA\$1CARRIER\$1UNREACHABLE（无法联系运营商）**– 当消息收件人的运营商网络发生暂时性错误时，就会发生无法联系运营商事件。
+ **MEDIA\$1BLOCKED（已屏蔽）**– 当收件人的设备或运营商屏蔽发送给该收件人的消息时，就会发生屏蔽事件。
+ **MEDIA\$1CARRIER\$1BLOCKED（运营商被阻止）**– 当收件人的运营商阻止消息传送时，就会发生运营商被阻止事件。当运营商将消息识别为恶意消息（例如，其中包含与钓鱼骗术相关的信息）或滥用消息（例如，消息被怀疑是未经请求的或违禁的）时，就会发生这种情况。
+ **MEDIA\$1SPAM（垃圾消息）**– 当收件人的运营商识别出消息中包含未经请求的商业内容并阻止传送消息时，就会发生垃圾消息事件。
+ **MEDIA\$1UNKNOWN（未知）**– 当消息由于其他事件类型未涵盖的原因而未能传送时，就会发生未知事件。未知错误可能是暂时的，也可能是永久性的。
+ **MEDIA\$1TTL\$1EXPIRED（TTL 已过期）**– 当传送消息所需的时间超过您在发送消息时指定的 `TTL` 值时，就会发生 TTL 过期事件。
+ **MEDIA\$1FILE\$1TYPE\$1UNSUPPORTED（文件类型不受支持）**– 当媒体文件的格式不受支持时，就会发生文件类型不受支持事件。有关支持的文件类型列表，请参阅[彩信文件类型、大小和字符限制](mms-limitations-character.md)。
+ **MEDIA\$1FILE\$1SIZE\$1EXCEEDED（文件大小）**– 当媒体文件的大小超过 600 KB 时，就会发生文件大小已超出事件。
+ **MEDIA\$1FILE\$1INACCESSIBLE（文件不可访问）**— 当 AWS 最终用户消息短信无权访问文件时，就会发生文件无法访问事件。
# AWS 最终用户消息 SMS 事件数据示例
AWS 最终用户消息 SMS 可以流式传输短信、彩信和语音消息传送的事件数据。由于接收运营商生成的事件可能需要长达 72 小时，因此不应依赖这些事件来判断出站消息是否存在延迟。72 小时后，如果 AWS 最终用户消息短信未收到运营商的最终事件，则该服务会自动返回，`UNKNOWN``messageStatus`因为我们不知道该消息发生了什么。
**Topics**
+ [短信示例日志](#configuration-sets-event-format-sms-example)
+ [短信保护示例日志](#configuration-sets-event-format-sms-protect-example)
+ [语音示例事件日志](#configuration-sets-event-format-voice-example)
+ [彩信示例日志](#configuration-sets-event-format-mms-example)
## 短信示例日志
短信事件的 JSON 对象包含以下示例中显示的数据。
```
{
"eventType": "TEXT_SUCCESSFUL",
"eventVersion": "1.0",
"eventTimestamp": 1686975103470,
"isFinal": true,
"originationPhoneNumber": "+12065550152",
"destinationPhoneNumber": "+14255550156",
"isInternationalSend": false,
"mcc": "310",
"mnc": "800",
"messageId": "862a8790-60c0-4430-9b2b-658bdexample",
"messageRequestTimestamp": 1686975103170,
"messageEncoding": "GSM",
"messageType": "PROMOTIONAL",
"messageStatus": "SUCCESSFUL",
"messageStatusDescription": "Message has been accepted by phone carrier",
"context": {
"account": "bar"
},
"totalMessageParts": 1,
"totalMessagePrice": 0.09582,
"totalCarrierFee": 0.0
}
```
****
| 属性 | 说明 |
| --- | --- |
| eventType | 事件类型。值列在 [短信、彩信和语音的事件类型](configuration-sets-event-types.md) 中 |
| eventVersion | 事件 JSON 架构的版本。 |
| eventTimestamp | 报告事件的时间，显示为以毫秒为单位的 Unix 时间。 |
| isFinal | 如果此为消息的最终状态，则为 True。有中间消息状态，可能需要长达 72 小时才能收到最终消息状态。 |
| originationPhoneNumber | 用于发送消息的电话号码。 |
| destinationPhoneNumber | 尝试将消息发送到的电话号码。 |
| isInternationalSend | 如果此电话号码启用了国际消息收发功能，则为 True。 |
| isoCountryCode | 与接收人的电话号码关联的国家，按 ISO 3166-1 alpha-2 格式显示。 |
| mcc | 移动国家/地区代码用于标识电话号码所属的国家/地区。此字段为可选字段，可能不存在。 |
| mnc | 移动网络代码用于标识移动网络运营商。此字段为可选字段，可能不存在。 |
| messageId | AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。 |
| messageRequestTimestamp | 接收短信请求的时间，显示为以毫秒为单位的 Unix 时间。 |
| messageEncoding | 消息的编码。可能的值为 GSM 和 Unicode。有关消息编码的更多信息，请参阅[短信字符限制](sms-limitations-character.md)。 |
| messageType | 消息类型。可能的值为 Promotional 和 Transactional。 |
| messageStatus | 消息的状态。可能的值有： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | 消息状态的描述。 |
| context | 您可以指定并将在您发送消息时被记录的自定义属性。 |
| totalMessageParts | AWS 最终用户消息 SMS 为发送消息而创建的消息部分的数量。 通常，短信只能包含 160 个 GSM-7 字符或 67 个非 GSM 字符，但这些限制会因国家而异。如果您发送的消息超过了这些限制，则 AWS 最终用户消息短信会自动将消息拆分为较小的部分。我们根据您发送的消息部分数量收取费用。有关消息部分的更多信息，请参阅[每秒消息部分数（MPS）限制是什么](sms-limitations-mps.md)。 |
| totalMessagePrice | 我们向您收取的发送消息的费用。此价格以千分之一美分显示。例如，如果此属性的值为 645，则我们收取的消息发送单价是 0.645¢ (645 / 1000 = 0.645¢ = \$10.00645)。 |
| totalCarrierFee | 消息的运营商费用总成本。 |
## 短信保护示例日志
使用[短信保护](protect.md)时，短信事件的 JSON 对象包含以下示例中显示的数据。
```
{
"eventType": "TEXT_PROTECT_BLOCKED",
"eventVersion": "1.0",
"eventTimestamp": 1686975103470,
"isFinal": true,
"originationPhoneNumber": "+12065550152",
"destinationPhoneNumber": "+14255550156",
"isoCountryCode": "US",
"mcc": "310",
"mnc": "800",
"messageId": "862a8790-60c0-4430-9b2b-658bdexample",
"messageRequestTimestamp": 1686975103170,
"messageEncoding": "GSM",
"messageType": "PROMOTIONAL",
"messageStatus": "PROTECT_BLOCKED",
"messageStatusDescription": "Message blocked by protect configuration",
"context": {
"account": "bar"
},
"totalMessageParts": 1,
"totalMessagePrice": 0,
"totalCarrierFee": 0,
"protectConfiguration": {
"protectConfigurationId": "protect-d777777777777771bbd5d59f4d903479",
"protectStatus": "FILTER"
},
"protectConfigurationAssessment": {
"protectRecommendation": "BLOCK"
"protectInsights": {
"blockReason": "AIT_SUSPECTED"
}
}
}
```
****
| 属性 | 说明 |
| --- | --- |
| eventType | 事件类型。值列在 [短信、彩信和语音的事件类型](configuration-sets-event-types.md) 中 |
| eventVersion | 事件 JSON 架构的版本。 |
| eventTimestamp | 报告事件的时间，显示为以毫秒为单位的 Unix 时间。 |
| isFinal | 如果此为消息的最终状态，则为 True。有中间消息状态，可能需要长达 72 小时才能收到最终消息状态。 |
| originationPhoneNumber | 用于发送消息的电话号码。 |
| destinationPhoneNumber | 尝试将消息发送到的电话号码。 |
| isoCountryCode | 与接收人的电话号码关联的国家，按 ISO 3166-1 alpha-2 格式显示。 |
| mcc | 移动国家/地区代码用于标识电话号码所属的国家/地区。此字段为可选字段，可能不存在。 |
| mnc | 移动网络代码用于标识移动网络运营商。此字段为可选字段，可能不存在。 |
| messageId | AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。 |
| messageRequestTimestamp | 接收短信请求的时间，显示为以毫秒为单位的 Unix 时间。 |
| messageEncoding | 消息的编码。可能的值为 GSM 和 Unicode。有关消息编码的更多信息，请参阅[短信字符限制](sms-limitations-character.md)。 |
| messageType | 消息类型。可能的值为 Promotional 和 Transactional。 |
| messageStatus | 消息的状态。可能的值有： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | 消息状态的描述。 |
| context | 您可以指定并将在您发送消息时被记录的自定义属性。 |
| totalMessageParts | AWS 最终用户消息 SMS 为发送消息而创建的消息部分的数量。 通常，短信只能包含 160 个 GSM-7 字符或 67 个非 GSM 字符，但这些限制会因国家而异。如果您发送的消息超过了这些限制，则 AWS 最终用户消息短信会自动将消息拆分为较小的部分。我们根据您发送的消息部分数量收取费用。有关消息部分的更多信息，请参阅[每秒消息部分数（MPS）限制是什么](sms-limitations-mps.md)。 |
| totalMessagePrice | 我们向您收取的发送消息的费用。此价格以千分之一美分显示。例如，如果此属性的值为 645，则我们收取的消息发送单价是 0.645¢ (645 / 1000 = 0.645¢ = \$10.00645)。 |
| totalCarrierFee | 消息的运营商费用总成本。 |
| protectConfiguration | 发送消息时使用的保护配置的 ID 以及目标国家/地区当时的状态。有关短信保护的更多信息，请参阅[短信保护](protect.md)。 |
| protectConfigurationAssessment | 评估短信保护认为您的消息应允许发送还是阻止发送，并提供阻止原因（如果有）。 |
## 语音示例事件日志
语音事件的 JSON 对象包含以下示例显示的数据。
```
{
"eventType": "VOICE_COMPLETED",
"eventVersion": "1.0",
"eventTimestamp": 1697835373500,
"isFinal": true,
"originationPhoneNumber": "+12065550153",
"destinationPhoneNumber": "+14255550159",
"isoCountryCode": "US",
"messageId": "567f6c11-6e8b-4352-9749-a42a0example",
"messageRequestTimestamp": 1697835372720,
"messageStatus": "COMPLETED",
"callDurationInSeconds": 60,
"totalDurationInMinutes": 1,
"totalMessagePrice": 0.013,
"context": {
"account": "bar"
}
}
```
****
| 属性 | 说明 |
| --- | --- |
| eventType | 事件类型。值列在 [短信、彩信和语音的事件类型](configuration-sets-event-types.md) 中 |
| eventVersion | 事件 JSON 架构的版本。 |
| eventTimestamp | 报告事件的时间，显示为以毫秒为单位的 Unix 时间。 |
| isFinal | 如果此为消息的最终状态，则为 True。有中间消息状态。 |
| originationPhoneNumber | 用于发送消息的电话号码。 |
| destinationPhoneNumber | 尝试将消息发送到的电话号码。 |
| isoCountryCode | 与接收人的电话号码关联的国家，按 ISO 3166-1 alpha-2 格式显示。 |
| messageId | AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。 |
| messageRequestTimestamp | 接收短信请求的时间，显示为以毫秒为单位的 Unix 时间。 |
| messageStatus | 消息的状态。可能的值有： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| callDurationInSeconds | 通话持续时间（以秒为单位）。 |
| totalDurationInMinutes | 通话持续时间（以分钟为单位）。 |
| totalMessagePrice | 我们向您收取的发送语音消息的费用。此价格以千分之一美分显示。 |
| context | 您可以指定并将在您发送消息时被记录的自定义属性。 |
## 彩信示例日志
彩信事件的 JSON 对象包含以下示例显示的数据。
```
{
"contentType":"MMS",
"eventType": "MEDIA_DELIVERED",
"eventVersion": "1.0",
"eventTimestamp": 1635197695208,
"isFinal": true,
"originationPhoneNumber": "+12065550153",
"destinationPhoneNumber": "+14255550159",
"isoCountryCode": "US",
"messageId": "b4a3196d-5b61-4884-a0d9-745acf1f6235example",
"messageRequestTimestamp": 1635197693241,
"messageType": "TRANSACTIONAL",
"messageStatus": "DELIVERED",
"messageStatusDescription": "Message has been accepted by phone",
"context": {"foo":"bar"},
"totalMessageParts": 1,
"totalMessagePrice": 0.0195,
"totalCarrierFee": 0.00266
}
```
****
| 属性 | 说明 |
| --- | --- |
| eventType | 事件类型。值列在 [短信、彩信和语音的事件类型](configuration-sets-event-types.md) 中 |
| eventVersion | 事件 JSON 架构的版本。 |
| eventTimestamp | 报告事件的时间，显示为以毫秒为单位的 Unix 时间。 |
| isFinal | 如果此为消息的最终状态，则为 True。有中间消息状态，可能需要长达 72 小时才能收到最终消息状态。 |
| originationPhoneNumber | 用于发送消息的电话号码。 |
| destinationPhoneNumber | 尝试将消息发送到的电话号码。 |
| isoCountryCode | 与接收人的电话号码关联的国家，按 ISO 3166-1 alpha-2 格式显示。 |
| messageId | AWS 最终用户消息 SMS 在接受消息时生成的唯一 ID。 |
| messageRequestTimestamp | 接收短信请求的时间，显示为以毫秒为单位的 Unix 时间。 |
| messageType | 消息类型。可能的值为 Promotional 和 Transactional。 |
| messageStatus | 消息的状态。可能的值有： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | 消息状态的描述。 |
| context | 您可以指定并将在您发送消息时被记录的自定义属性。 |
| totalMessageParts | AWS 最终用户消息 SMS 为发送消息而创建的消息部分的数量。有关消息部分的更多信息，请参阅[每秒消息部分数（MPS）限制是什么](sms-limitations-mps.md)。 |
| totalMessagePrice | 我们向您收取的发送消息的费用。此价格以千分之一美分显示。例如，如果此属性的值为 645，则我们收取的消息发送单价是 0.645¢ (645 / 1000 = 0.645¢ = \$10.00645)。 |
| totalCarrierFee | 消息的运营商费用总成本。 |
# 在 AWS 最终用户消息 SMS 中设置 Amazon CloudWatch 事件目的地
Amazon CloudWatch Logs 是一项可用于监控、存储和访问日志文件的 AWS 服务。创建 CloudWatch 事件目标时， AWS 最终用户消息 SMS 会将您在事件目标中指定的事件类型发送到群 CloudWatch 组。要了解更多信息 CloudWatch，请参阅 [Amazon CloudWatch 日志用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/)。
**先决条件**
1. 在创建 CloudWatch 活动目的地之前，必须先创建一个 CloudWatch群组。有关创建日志组的更多信息，请参阅 *Amazon 日志用户指南中的使用日志组和 CloudWatch 日志*[流](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)。
**重要**
您需要 CloudWatch 群组的 Amazon 资源名称 (ARN) 才能创建活动目的地。
1. 您必须创建允许 AWS 最终用户消息 SMS 写入日志组的 [IAM 角色](configuration-sets-cloud-watch-creating-role.md#configuration-sets-cloud-watch-creating-role.title)。
**重要**
要创建事件目标，您需要提供 IAM 角色的 Amazon 资源名称（ARN）。
1. 您还需设置一个用于关联事件目标的配置集，请参阅[在 AWS 终端用户消息发送 SMS 服务中创建配置集](configuration-set-create.md)。
# 适用于亚马逊 IAM 的政策 CloudWatch
使用以下示例创建用于向 CloudWatch群组发送事件的策略。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:CreateLogStream",
"logs:DescribeLogStreams",
"logs:PutLogEvents"
],
"Resource": [
"arn:aws:logs:us-east-1:111122223333:log-group:log-group-name:*"
]
}
]
}
```
------
有关 IAM 策略的更多信息，请参阅《IAM 用户指南》中的 ** [IAM 中的策略与权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
以下示例语句使用可选但推荐的`SourceAccount`和`SourceArn`条件来检查是否只有 AWS 最终用户消息 SMS 所有者帐户才有权访问配置集。在此示例中，*accountId*用您的 AWS 账户 ID、*region*配置集的 AWS 区域 *ConfigSetName*名称和名称替换。
创建策略之后，创建一个新的 IAM 角色，然后将策略附加给该角色。创建角色时，还要向其添加以下信任策略：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
}
```
------
有关创建 IAM 角色的更多信息，请参阅《IAM 用户指南》**中的[创建 IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html)。
# 在 AWS 最终用户消息 SMS 中创建 Amazon CloudWatch 事件目的地
创建 IAM 角色和 CloudWatch 群组后，您可以创建事件目的地。
------
#### [ Create event destination (Console) ]
要使用 AWS 最终用户消息 SMS 控制台创建事件目的地，请执行以下步骤：
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**配置集**。
1. 在**配置集**页面上，选择要添加事件目标的配置集。
1. 在**配置集详细信息**页面上，选择**添加目标事件**。
1. 在**事件详细信息**部分下，对于**事件目标名称**，输入一个易记名称。
1. 从**目的地类型**下拉列表中选择 Amazon CloudWatch。
1. 对于 **IAM 角色 ARN**，输入该 IAM 角色的 ARN。有关 IAM 角色 ARN 的更多信息，请参阅 [适用于亚马逊 IAM 的政策 CloudWatch](configuration-sets-cloud-watch-creating-role.md)。
1. 对于**日志组 arn**，输入要将事件传送到的 A CloudWatch mazon 日志组的 ARN。
1. 开启**事件发布**。
1. 在**事件类型**下，选择：
+ **所有 SMS 事件（推荐）**— 选择此选项可将列出的所有短信事件发送[事件类型](configuration-sets-event-types.md)到 Amazon CloudWatch。
+ **自定义 SMS 事件**-选择要发送到的特定短信事件 CloudWatch。要编辑事件列表，请选择**编辑短信事件选择**。在 **“编辑短信事件” 选项中，仅勾选**您要发送到 Amazon 的事件 CloudWatch。选择**保存选择**。
+ **所有语音事件（推荐）**-选择此选项可将列出的所有语音事件发送[事件类型](configuration-sets-event-types.md)到 Amazon CloudWatch。
+ **自定义语音事件**-选择要发送到的特定语音事件 CloudWatch。要编辑事件列表，请选择**编辑语音事件选择**。在 **“编辑语音事件选择” 上，仅勾选**您要发送到 Amazon 的事件 CloudWatch。选择**保存选择**。
+ **所有彩信事件（推荐）**— 选择此选项可将列出的所有彩信事件发送到 [事件类型](configuration-sets-event-types.md) Amazon。 CloudWatch
+ **自定义彩信事件**-选择要发送到的特定彩信事件。 CloudWatch要编辑事件列表，请选择**编辑彩信事件选择**。在 **“编辑彩信” 事件选择中，仅勾选**您要发送至 Amazon CloudWatch 的事件。选择**保存选择**。
1. 选择 **Create event (创建事件)**。
------
#### [ Create event destination (AWS CLI) ]
您可以使用[create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)命令来创建事件目的地。
在命令行处，运行以下命令：
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```
在前面的命令中，进行以下更改：
+ *eventDestinationName*替换为描述事件目的地的名称。
+ 替换为要*configurationSet*与事件目标关联的配置集的名称。
+ *eventTypes*替换为中列出的一个或多个事件类型[短信、彩信和语音的事件类型](configuration-sets-event-types.md)。
+ 将 `IamRoleArn` 的值替换为具有[适用于亚马逊 IAM 的政策 CloudWatch](configuration-sets-cloud-watch-creating-role.md)中所述策略的 IAM 角色的 Amazon 资源名称 (ARN)。
+ 将的`LogGroupArn`值替换为您要向其发送事件的 CloudWatch 群组的 ARN。
------
# 在 AWS 最终用户消息 SMS 中编辑 Amazon CloudWatch 事件目的地
使用 AWS 最终用户消息 SMS 控制台或 AWS CLI 编辑 CloudWatch 事件目的地。
------
#### [ Update event destination (Console) ]
要使用 AWS 最终用户消息 SMS 控制台更新事件目的地，请执行以下步骤：
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**配置集**。
1. 在**配置集**页面上，选择要编辑的配置集。
1. 在**活动设置**选项卡上，选择一个 Amazon CloudWatch 活动目的地，然后选择 **“编辑”**。
1. 对于 **IAM 角色 ARN**，输入该 IAM 角色的 ARN。有关 IAM 角色 ARN 的更多信息，请参阅 [适用于亚马逊 IAM 的政策 CloudWatch](configuration-sets-cloud-watch-creating-role.md)。
1. 对于**日志组 arn**，输入要将事件传送到的 A CloudWatch mazon 日志组的 ARN。
1. 在**事件类型**下，选择：
+ **所有 SMS 事件（推荐）**— 选择此选项可将列出的所有短信事件发送[事件类型](configuration-sets-event-types.md)到 Amazon CloudWatch。
+ **自定义短信事件**-选择此选项选择要发送到的特定短信事件 CloudWatch。要编辑事件列表，请选择**编辑短信事件选择**。在 **“编辑短信事件” 选项中，仅勾选**您要发送到 Amazon 的事件 CloudWatch。选择**保存选择**。
+ **所有语音事件（推荐）**-选择此选项可将列出的所有语音事件发送[事件类型](configuration-sets-event-types.md)到 Amazon CloudWatch。
+ **自定义语音事件**-选择此选项选择要发送到的特定语音事件 CloudWatch。要编辑事件列表，请选择**编辑语音事件选择**。在 **“编辑语音事件选择” 上，仅勾选**您要发送到 Amazon 的事件 CloudWatch。选择**保存选择**。
+ **所有彩信事件（推荐）**— 选择此选项可将列出的所有彩信事件发送到 [事件类型](configuration-sets-event-types.md) Amazon。 CloudWatch
+ **自定义彩信事件**-选择此选项选择要发送到的特定彩信事件。 CloudWatch要编辑事件列表，请选择**编辑彩信事件选择**。在 **“编辑彩信” 事件选择中，仅勾选**您要发送至 Amazon CloudWatch 的事件。选择**保存选择**。
1. 选择**编辑事件**。
------
#### [ Update event destination AWS CLI) ]
您可以使用[update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)命令更新事件目的地。
更新 CloudWatch 事件目标的过程与创建事件目标的过程类似。在命令行处，运行以下命令：
```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```
在前面的命令中，进行以下更改：
+ *eventDestinationName*替换为要修改的事件目的地的名称。
+ 替换为要*configurationSet*与事件目标关联的配置集的名称。您可以将事件目标与另外的配置集相关联。
+ *eventTypes*替换为中列出的事件类型之一[短信、彩信和语音的事件类型](configuration-sets-event-types.md)。
+ 将 `IamRoleArn` 的值替换为具有[短信、彩信和语音的事件类型](configuration-sets-event-types.md)中所述策略的 IAM 角色的 Amazon 资源名称 (ARN)。
+ 将的`LogGroupArn`值替换为您要向其发送事件的 CloudWatch 群组的 ARN。
------
# 删除 “ AWS 最终用户消息” 短信中的 Amazon CloudWatch 事件目的地
使用 AWS 最终用户消息 SMS 控制台或 AWS CLI 删除 CloudWatch 事件目的地。
------
#### [ Delete an CloudWatch event destination (Console) ]
无论您要删除的事件目标的类型如何，删除事件目标的过程都是一样的。
**在控制台中删除 CloudWatch 事件目的地**
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**配置集**。
1. 在**配置集**页面上，选择要从中移除事件目标的配置集。
1. 在**所有目标**部分选择一个事件目标，然后选择**删除**。
------
#### [ Delete an CloudWatch event destination (AWS CLI) ]
您可以使用[delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)命令删除事件目的地。
无论您要删除的事件目标的类型如何，删除事件目标的过程都是一样的。
**要删除中的 CloudWatch 活动目的地 AWS CLI**
+ 在命令行处，运行以下命令：
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
在前面的命令中，进行以下更改：
+ *eventDestinationName*替换为您要删除的事件目的地的名称或 Amazon 资源名称 (ARN)。
+ 替换为*configurationSetName*与事件目标关联的配置集的名称或 ARN。
------
# 在最终用户消息短信中设置 Amazon Data Firehose 事件目的地 AWS
Amazon Data Firehose 是一项完全托管的服务，用于将实时流数据传送到多种类型的目标。Amazon Data Firehose 是 Kinesis 流数据平台的一部分。要了解有关 Amazon Data Firehose 的更多信息，请参阅 [Amazon Data Firehose 开发人员指南](https://docs.aws.amazon.com/firehose/latest/dev/)。
本节中的部分示例假定您已安装和配置 AWS Command Line Interface。有关设置的更多信息 AWS CLI，请参阅《[AWS Command Line Interface 用户指南》](https://docs.aws.amazon.com/cli/latest/userguide/)。
**先决条件**
1. 要创建 Amazon Data Firehose 事件目标，必须先创建 Amazon Data Firehose 传输流。有关创建流的更多信息，请参阅《Amazon Data Firehose 开发人员指南》**中的[创建 Amazon Data Firehose 传输流](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)。
**重要**
要创建事件目标，您需要提供 Amazon Data Firehose 传输流的 Amazon 资源名称（ARN）。
1. 您必须创建一个 IAM 角色以允许 AWS 最终用户消息 SMS 写入传送流，请参阅[Amazon Data Firehose 的 IAM 策略](configuration-sets-kinesis-creating-role.md)。
**重要**
要创建事件目标，您需要提供 IAM 角色的 Amazon 资源名称（ARN）。
1. 您还需设置一个用于关联事件目标的配置集，请参阅[在 AWS 终端用户消息发送 SMS 服务中创建配置集](configuration-set-create.md)。
**Topics**
+ [Amazon Data Firehose 的 IAM 策略](configuration-sets-kinesis-creating-role.md)
+ [创建 Amazon Data Firehose 事件目的地](configuration-set-kinesis-add.md)
+ [编辑 Amazon Data Firehose 事件目的地](configuration-set-kinesis-edit.md)
+ [删除 Amazon Data Firehose 事件目的地](configuration-set-kinesis-delete.md)
# Amazon Data Firehose 的 IAM 策略
使用以下示例创建用于向 Amazon Data Firehose 流发送事件的策略。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "firehose:PutRecord",
"Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName"
}
]
}
```
------
有关 IAM 策略的更多信息，请参阅《IAM 用户指南》中的 ** [IAM 中的策略与权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
以下示例语句使用可选但推荐的`SourceAccount`和`SourceArn`条件来检查是否只有 AWS 最终用户消息 SMS 所有者帐户才有权访问配置集。在此示例中，*accountId*用您的 AWS 账户 ID、*region*配置集的 AWS 区域 *ConfigSetName*名称和名称替换。
创建策略之后，创建一个新的 IAM 角色，然后将策略附加给该角色。创建角色时，还要向其添加以下信任策略：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
}
```
------
有关创建 IAM 角色的更多信息，请参阅《IAM 用户指南》**中的[创建 IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html)。
# 在 AWS 最终用户消息短信中创建 Amazon Data Firehose 事件目的地
在创建亚马逊数据 Firehose 事件目标之前，必须先创建亚马逊数据 Firehose 流。有关创建日志组的更多信息，请参阅《亚马逊数据 Fire [hose 开发者指南》中的创建*亚马逊数据 Firehose* 传输](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)流。
您必须创建一个 IAM 角色以允许 AWS 最终用户消息 SMS 和 Voice v2 API 向直播发送数据。下一节包含有关该角色要求的信息。
您还需要已经设置了与事件目标关联的配置集，请参阅[AWS 终端用户消息发送 SMS 服务中的配置集](configuration-sets.md)。
------
#### [ Create Amazon Data Firehose event destination (Console) ]
要使用 AWS 最终用户消息短信控制台创建 Amazon Data Firehose 事件目的地，请按照以下步骤操作：
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格的**配置**下，选择**配置集**。
1. 在**配置集**页面上，选择要向其添加事件目标的配置集。
1. 在**配置集详细信息**页面上，选择**添加目标事件**。
1. 在**活动详细信息**部分下，为**活动目的地名称输入一个友好名称**。
1. 从**目的地类型**下拉列表中选择 Amazon Data Firehose。
1. 对于 **IAM 角色 arn**，请输入 IAM 角色的 ARN。有关 IAM 角色 arn 的更多信息，请参阅[Amazon Data Firehose 的 IAM 策略](configuration-sets-kinesis-creating-role.md)。
1. 对于**传送流 arn**，请输入要将事件传送到的 Amazon Data Firehose 日志组的 ARN。
1. 开启**活动发布**。
1. 在 “**事件类型**” 下，选择：
+ **所有短信事件（推荐）**— 选择此选项可将中列出的所有短信事件发送[事件类型](configuration-sets-event-types.md)到 Amazon Data Firehose。
+ **自定义短信事件**-选择要发送到 Amazon Data Firehose 的特定短信事件。要编辑事件列表，请选择**编辑短信事件选择**。在 **“编辑短信事件” 选项中，仅勾选**您要发送到 Amazon Data Firehose 的事件。选择 “**保存选择**”。
+ **所有语音事件（推荐）**— 选择此选项可将中列出的所有语音事件发送[事件类型](configuration-sets-event-types.md)到 Amazon Data Firehose。
+ **自定义语音事件**-选择要发送到 Amazon Data Firehose 的特定语音事件。要编辑事件列表，请选择**编辑语音事件选择**。在 **“编辑语音事件选择” 中，仅勾选**要发送到 Amazon Data Firehose 的事件。选择 “**保存选择**”。
+ **所有彩信事件（推荐）**— 选择此选项可将中列出的所有彩信事件发送到 [事件类型](configuration-sets-event-types.md) Amazon Data Firehose。
+ **自定义彩信事件** — 选择要发送到 Amazon Data Firehose 的特定彩信事件。要编辑事件列表，请选择**编辑彩信事件选择**。在 **“编辑彩信” 事件选择中，仅勾选**您要发送到 Amazon Data Firehose 的事件。选择 “**保存选择**”。
1. 选择 **Create event (创建事件)**。
------
#### [ Create Amazon Data Firehose event destination (AWS CLI) ]
创建 IAM 角色和 Amazon Data Firehose 传输流后，您可以创建事件目的地。
您可以使用[create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)命令来创建事件目的地。
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream
```
在前面的命令中，进行以下更改：
+ *eventDestinationName*替换为描述事件目的地的名称。
+ 替换为要*configurationSet*与事件目标关联的配置集的名称。
+ *eventTypes*替换为中列出的一个或多个事件类型[短信、彩信和语音的事件类型](configuration-sets-event-types.md)。
+ 将 `IamRoleArn` 的值替换为具有[Amazon Data Firehose 的 IAM 策略](configuration-sets-kinesis-creating-role.md)中所述策略的 IAM 角色的 Amazon 资源名称 (ARN)。
+ 将的`DeliveryStreamArn`值替换为您要向其发送事件的 Amazon Data Firehose 流的 ARN。
------
# 在 AWS 最终用户消息短信中编辑 Amazon Data Firehose 事件目的地
使用 AWS 最终用户消息短信控制台或 AWS CLI 编辑 Amazon Data Firehose 事件目的地。
------
#### [ Update Amazon Data Firehose event destination (Console) ]
要使用 AWS 最终用户消息短信控制台更新 Amazon Data Firehose 事件目的地，请按照以下步骤操作：
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格的**配置**下，选择**配置集**。
1. 在**配置集**页面上，选择要向其添加事件目标的配置集。
1. 在**配置集**页面上，选择要编辑的配置集。
1. **在**配置集详情**页面上，选择一个 Amazon Data Firehose 事件目的地，然后选择 “编辑”。**
1. 对于 **IAM 角色 arn**，请输入 IAM 角色的 ARN。有关 IAM 角色 arn 的更多信息，请参阅[Amazon Data Firehose 的 IAM 策略](configuration-sets-kinesis-creating-role.md)。
1. 对于**传送流 arn**，请输入要将事件传送到的 Amazon Data Firehose 日志组的 ARN。
1. 在 “**事件类型**” 下，选择：
+ **所有短信事件（推荐）**— 选择此选项可将中列出的所有短信事件发送[事件类型](configuration-sets-event-types.md)到 Amazon Data Firehose。
+ **自定义 SMS 事件**-选择此选项选择要发送到的特定短信事件 CloudWatch。要编辑事件列表，请选择**编辑短信事件选择**。在 **“编辑短信事件” 选项中，仅勾选**您要发送到 Amazon Data Firehose 的事件。选择 “**保存选择**”。
+ **所有语音事件（推荐）**— 选择此选项可将中列出的所有语音事件发送[事件类型](configuration-sets-event-types.md)到 Amazon Data Firehose。
+ **自定义语音事件**-选择此选项选择要发送到 Amazon Data Firehose 的特定语音事件。要编辑事件列表，请选择**编辑语音事件选择**。在 **“编辑语音事件选择” 中，仅勾选**要发送到 Amazon Data Firehose 的事件。选择 “**保存选择**”。
+ **所有彩信事件（推荐）**— 选择此选项可将中列出的所有彩信事件发送到 [事件类型](configuration-sets-event-types.md) Amazon Data Firehose。
+ **自定义彩信事件**-选择此选项选择要发送到的特定彩信事件。 CloudWatch要编辑事件列表，请选择**编辑彩信事件选择**。在 **“编辑彩信” 事件选择中，仅勾选**您要发送到 Amazon Data Firehose 的事件。选择 “**保存选择**”。
1. 选择**编辑事件**。
------
#### [ Update Amazon Data Firehose event destination (AWS CLI) ]
您可以使用[update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)命令来更新事件目的地。
更新 Amazon Data Firehose 事件目标的过程与创建事件目标的过程类似。
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream
```
在前面的命令中，进行以下更改：
+ *eventDestinationName*替换为要修改的事件目的地的名称。
+ 替换为要*configurationSet*与事件目标关联的配置集的名称。您可以将事件目标与另外的配置集相关联。
+ *eventTypes*替换为中列出的事件类型之一[短信、彩信和语音的事件类型](configuration-sets-event-types.md)。
+ 将 `IamRoleArn` 的值替换为具有[Amazon Data Firehose 的 IAM 策略](configuration-sets-kinesis-creating-role.md)中所述策略的 IAM 角色的 Amazon 资源名称 (ARN)。
+ 将的`DeliveryStreamArn`值替换为您要向其发送事件的 Amazon Data Firehose 流的 ARN。
------
# 在 AWS 最终用户消息短信中删除 Amazon Data Firehose 事件目的地
使用 AWS 最终用户消息短信控制台或 AWS CLI 删除 Amazon Data Firehose 事件目的地。
------
#### [ Delete an Amazon Data Firehose event destination (Console) ]
无论您要删除的事件目标的类型如何，删除事件目标的过程都是一样的。
**在控制台中删除 Amazon Data Firehose 事件目的地**
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格的**配置**下，选择**配置集**。
1. 在**配置集**页面上，选择要从中删除事件目标的配置集。
1. 在 “**所有目的地**” 部分中，选择活动目的地，然后选择 “**删除**”。
------
#### [ Delete an Amazon Data Firehose event destination (AWS CLI) ]
您可以使用[delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)命令删除事件目的地。
无论您要删除的事件目标的类型如何，删除事件目标的过程都是一样的。
**要删除 Amazon Data Firehose 事件目的地 AWS CLI**
+ 在命令行处，运行以下命令：
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
在前面的命令中，进行以下更改：
+ *eventDestinationName*替换为您要删除的事件目的地的名称或 Amazon 资源名称 (ARN)。
+ 替换为*configurationSetName*与事件目标关联的配置集的名称或 ARN。
------
# 在最终用户消息短信中 AWS 设置 Amazon SNS 事件目的地
Amazon Simple Notification Service (Amazon SNS) 是一项 Web 服务，它使应用程序、终端用户和设备能够立即发送和接收通知。有关 Amazon SNS 的更多信息，请参阅 [Amazon Simple Notification Service 开发人员指南](https://docs.aws.amazon.com/sns/latest/dg/)。
本节中的部分示例假定您已安装和配置 AWS Command Line Interface。有关设置的更多信息 AWS CLI，请参阅《[AWS Command Line Interface 用户指南》](https://docs.aws.amazon.com/cli/latest/userguide/)。
**Topics**
+ [Amazon SNS 访问策略](configuration-sets-sns-creating-role.md)
+ [创建亚马逊 SNS 活动目的地](configuration-sets-sns-add.md)
+ [编辑 Amazon SNS 活动目的地](configuration-sets-sns-edit.md)
+ [删除 Amazon SNS 活动目的地](configuration-sets-sns-delete.md)
# Amazon SNS 访问策略
对 Amazon SNS 主题的访问由附加到 Amazon SNS 主题的*资源策略*控制，这也称为*访问策略*。有关 Amazon SNS *访问策略*的更多信息，请参阅《Amazon SNS 开发人员指南》**中的[身份和访问管理](https://docs.aws.amazon.com/sns/latest/dg/security-iam.html)。
**注意**
如果您的 Amazon SNS 主题启用了服务器端加密， AWS Key Management Service 则还要将该策略添加到关联的[对称加密](#configuration-sets-sns-creating-role-encrypted)客户托管密钥中。
使用以下声明更新*访问策略*，以允许在 Amazon SNS 主题中发布 AWS 最终用户消息 SMS。
+ *111122223333*替换为 AWS 账户的唯一 ID。
+ *TopicName*替换为 Amazon SNS 主题的名称。
+ *Region*替换为包 AWS 区域 含 Amazon SNS 主题和配置集的。
+ 将 *ConfigSetName* 替换为配置集的名称。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:TopicName",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
]
}
```
------
## 加密 Amazon SNS 主题的访问策略
如果您的 Amazon SNS 主题启用了服务器端加密 AWS Key Management Service，请将以下策略添加到关联的对称加密客户托管密钥中。您必须将策略添加到客户托管密钥中，因为您无法修改 Amazon SNS 的 AWS 托管密钥。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "example-ID",
"Statement": [
{
"Sid": "example-statement-ID",
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
]
}
```
------
# 在 AWS 最终用户消息短信中创建 Amazon SNS 事件目的地
在创建 Amazon SNS 事件目标之前，必须先创建 Amazon SNS 主题。有关创建 Amazon SNS 主题的更多信息，请参阅《*亚马逊简单通知服务开发者*指南》中的[创建主题](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html)。
您还必须已经设置了与事件目的地关联的配置集，请参阅[AWS 终端用户消息发送 SMS 服务中的配置集](configuration-sets.md)。
------
#### [ Create an Amazon SNS event destination (Console) ]
要使用 AWS 最终用户消息 SMS 控制台创建 Amazon SNS 事件目的地，请执行以下步骤：
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格的**配置**下，选择**配置集**。
1. 在**配置集**页面上，选择要向其添加事件目标的配置集。
1. 在**配置集详细信息**页面上，选择**添加目标事件**。
1. 在**活动详情**部分下，输入名称。
1. 从**目的地类型**下拉列表中选择 Amazon SNS。
1. **全新 Amazon SNS 主题** — 选择此选项，让 AWS 最终用户消息短信在您的账户中创建主题。该主题将自动创建，并具有所有必需的权限。有关 Amazon SNS 主题的更多信息，请参阅[亚马逊[简单通知服务开发者指南中的配置 Amazon](https://docs.aws.amazon.com/sns/latest/dg/) SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html)。
1. **现有亚马逊 SNS 主题 — 如果您在 “主题** **arn” 下拉列表中已有 Amazon SNS 主题，请选择此选项。**
1. 在 “**事件类型**” 下，选择：
+ **所有短信事件（推荐）**-选择此选项可将中列出的所有短信事件发送[事件类型](configuration-sets-event-types.md)到 Amazon SNS。
+ **自定义短信事件**-选择要发送到 Amazon SNS 的特定短信事件。要编辑事件列表，请选择**编辑短信事件选择**。在 **“编辑短信事件” 选项中，仅勾选**您要发送到 Amazon SNS 的事件。选择 “**保存所选内容**”。
+ **所有语音事件（推荐）**-选择此选项可将中列出的所有语音事件发送[事件类型](configuration-sets-event-types.md)到 Amazon SNS。
+ **自定义语音事件**-选择要发送到 Amazon SNS 的特定语音事件。要编辑事件列表，请选择**编辑语音事件选择**。在 **“编辑语音事件选择” 中，仅勾选**您要发送到 Amazon SNS 的事件。选择 “**保存所选内容**”。
+ **所有彩信事件（推荐）**-选择此选项可将列出的所有彩信事件发送到 Amazon SNS。[事件类型](configuration-sets-event-types.md)
+ **自定义彩信事件**-选择要发送到 Amazon SNS 的特定彩信事件。要编辑事件列表，请选择**编辑彩信事件选择**。在 **“编辑彩信” 事件选择中，仅勾选**您要发送到 Amazon SNS 的事件。选择 “**保存所选内容**”。
1. 选择 **Create event (创建事件)**。
------
#### [ Create an Amazon SNS event destination (AWS CLI) ]
您可以使用[create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)命令来创建事件目的地。
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
在前面的命令中，进行以下更改：
+ *eventDestinationName*替换为事件目的地的描述性名称。
+ 替换为要*configurationSet*与事件目标关联的配置集的名称。
+ *eventTypes*替换为中列出的事件类型之一[短信、彩信和语音的事件类型](configuration-sets-event-types.md)。
+ 将 `TopicArn` 的值替换为您要向其发送事件的 Amazon SNS 主题的 Amazon 资源名称 (ARN)。
------
# 在 AWS 最终用户消息短信中编辑 Amazon SNS 事件目的地
使用 AWS 最终用户消息 SMS 控制台或 AWS CLI 编辑 Amazon SNS 事件目的地。
------
#### [ Update an Amazon SNS event destination (Console) ]
要使用 AWS 最终用户消息 SMS 控制台更新 AWS 最终用户消息 SMS 事件目的地，请执行以下步骤：
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格的**配置**下，选择**配置集**。
1. 在**配置集**页面上，选择要向其添加事件目标的配置集。
1. 在**配置集**页面上，选择要编辑的配置集。
1. **在**配置集详情**页面上，选择一个 Amazon SNS 事件目的地，然后选择 “编辑”。**
1. 从**目的地类型**下拉列表中选择 Amazon SNS。
1. **全新 Amazon SNS 主题** — 选择此选项，“ AWS 最终用户消息 SMS” 将在您的账户中创建一个主题。该主题将自动创建，并具有所有必需的权限。有关 Amazon SNS 主题的更多信息，请参阅[亚马逊[简单通知服务开发者指南中的配置 Amazon](https://docs.aws.amazon.com/sns/latest/dg/) SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html)。
1. **现有亚马逊 SNS 主题 — 如果您在 “主题** **arn” 下拉列表中已有 Amazon SNS 主题，请选择此选项。**
1. 在 “**事件类型**” 下，选择：
+ **所有短信事件（推荐）**-选择此选项可将中列出的所有短信事件发送[事件类型](configuration-sets-event-types.md)到 Amazon SNS。
+ **自定义短信事件**-选择此选项选择要发送到 Amazon SNS 的特定短信事件。要编辑事件列表，请选择**编辑短信事件选择**。在 **“编辑短信事件” 选项中，仅勾选**您要发送到 Amazon SNS 的事件。选择 “**保存选择**”。
+ **所有语音事件（推荐）**-选择此选项可将中列出的所有语音事件发送[事件类型](configuration-sets-event-types.md)到 Amazon SNS。
+ **自定义语音事件**-选择此选项选择要发送到 Amazon SNS 的特定语音事件。要编辑事件列表，请选择**编辑语音事件选择**。在 **“编辑语音事件选择” 中，仅勾选**您要发送到 Amazon SNS 的事件。选择 “**保存选择**”。
+ **所有彩信事件（推荐）**-选择此选项可将列出的所有彩信事件发送到 Amazon SNS。[事件类型](configuration-sets-event-types.md)
+ **自定义彩信事件**-选择此选项选择要发送到 Amazon SNS 的特定彩信事件。要编辑事件列表，请选择**编辑彩信事件选择**。在 **“编辑彩信” 事件选择中，仅勾选**您要发送到 Amazon SNS 的事件。选择 “**保存选择**”。
1. 选择**编辑事件**。
------
#### [ Update an Amazon SNS event destination (AWS CLI) ]
您可以使用[update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)命令来更新事件目的地。
更新 Amazon SNS 事件目标的过程与创建事件目标的过程类似。
**要在中更新 Amazon SNS 事件目的地 AWS CLI**
+ 在命令行处，运行以下命令：
```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
在前面的命令中，进行以下更改：
+ *eventDestinationName*替换为要修改的事件目的地的名称。
+ 替换为要*configurationSet*与事件目标关联的配置集的名称。您可以将事件目标与另外的配置集相关联。
+ *eventTypes*替换为中列出的一个或多个事件类型[短信、彩信和语音的事件类型](configuration-sets-event-types.md)。
+ 将 `TopicArn` 的值替换为您要向其发送事件的 Amazon SNS 主题的 Amazon 资源名称 (ARN)。
------
# 删除 “ AWS 最终用户消息” 短信中的 Amazon SNS 事件目的地
使用 AWS 最终用户消息短信控制台或 AWS CLI 删除 Amazon SNS 主题。
------
#### [ Delete an Amazon SNS event destination (Console) ]
无论您要删除的事件目标的类型如何，删除事件目标的过程都是一样的。
**在控制台中删除 Amazon SNS 事件目的地**
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格的**配置**下，选择**配置集**。
1. 在**配置集**页面上，选择要从中删除事件目标的配置集。
1. 在 “**所有目的地**” 部分中，选择活动目的地，然后选择 “**删除**”。
------
#### [ Delete an Amazon SNS event destination (AWS CLI) ]
您可以使用[delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)命令删除事件目的地。
无论您要删除的事件目标的类型如何，删除事件目标的过程都是一样的。
**要在中删除 Amazon SNS 事件目的地 AWS CLI**
+ 在命令行处，运行以下命令：
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
在前面的命令中，进行以下更改：
+ *eventDestinationName*替换为您要删除的事件目的地的名称或 Amazon 资源名称 (ARN)。
+ 替换为*configurationSetName*与事件目标关联的配置集的名称或 ARN。
------