

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 AWS 最终用户消息 SMS 中设置 Amazon CloudWatch 事件目的地
<a name="configuration-sets-cloud-watch"></a>

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
<a name="configuration-sets-cloud-watch-creating-role"></a>

使用以下示例创建用于向 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 事件目的地
<a name="configuration-sets-cloud-watch-add"></a>

创建 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 事件目的地
<a name="configuration-sets-cloud-watch-edit"></a>

使用 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 事件目的地
<a name="configuration-sets-cloud-watch-delete"></a>

使用 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。

------