本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在最终用户消息短信中设置 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。
------