配置集 - 亚马逊 Pinpoint 短信

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

配置集

配置集 是在您发送消息时应用的规则集。例如,配置集可以为与消息相关的事件指定目标。当短信事件(例如送达或失败事件)发生时,它们会被路由到与您在发送消息时指定的配置集关联的目标。虽然在您发送消息时不要求使用配置集,但我们建议您使用。如果您未指定带有事件目标的配置集,则该 API 不会发出事件记录。这些事件记录很有用,可用来确定您发送了多少消息、为每条消息支付了多少费用以及收件人是否收到消息,等等。

管理配置集

本节包含有关使用 AWS CLI 和 Amazon Pinpoint SMS 控制台管理配置集的信息。本节中的过程假定您已配置 AWS CLI。有关更多信息,请参阅《AWS Command Line Interface 用户指南》中的 AWS CLI入门

注意

创建配置集后,您需要至少添加一个用于记录事件的事件目的地。有关更多信息,请参阅 管理事件目标

或者,您可以将配置集与保护配置相关联,以生成允许或阻止向特定目的地国家/地区发送消息的国家/地区规则的自定义列表。要了解更多信息,请参阅 编辑配置集保护配置关联保护配置

Creating a configuration set (Console)

要使用 Amazon Pinpoint 短信控制台创建配置集,请执行以下步骤:

  1. 打开 Amazon Pinpoint SMS 控制台,网址为:https://console.aws.amazon.com/sms-voice/

  2. 在导航窗格的配置下,选择配置集,然后选择创建配置集

  3. 配置集名称中,输入配置集的描述性名称。

  4. 选择 “创建配置集”

Creating a configuration set (AWS CLI)

您可以使用create-configuration-set命令创建新的配置集。

$ aws pinpoint-sms-voice-v2 create-configuration-set \ > --configuration-set-name configurationSet

在前面的命令中,将 configurationSet 替换为要创建的配置集的名称。

Deleting a configuration set (Console)

要使用 Amazon Pinpoint 短信控制台删除配置集,请执行以下步骤:

  1. 打开 Amazon Pinpoint SMS 控制台,网址为:https://console.aws.amazon.com/sms-voice/

  2. 在导航窗格的配置下,选择配置集

  3. 选择要删除的配置集,然后选择 “删除”。

Deleting a configuration set (AWS CLI)

您可以使用delete-configuration-set命令删除配置集。

$ aws pinpoint-sms-voice-v2 delete-configuration-set \ > --configuration-set-name configurationSet

在前面的命令中,将 ConfigSet 替换为要删除的配置集的名称。

Edit configuration set settings (Console)

要使用 Amazon Pinpoint 短信控制台编辑配置集,请执行以下步骤:

  1. 打开 Amazon Pinpoint SMS 控制台,网址为:https://console.aws.amazon.com/sms-voice/

  2. 在导航窗格的配置下,选择配置集

  3. 配置集页面上,选择要编辑的配置集。

  4. 选择 “设置设置” 选项卡,然后选择 “编辑设置”

  5. “列表设置” 中,执行以下操作:

    • 留言类型可选择以下任一选项:

      • 促销 - 选择此选项可发送营销消息或宣传您的业务或服务的消息。

      • 事务性 - 选择此选项可发送对时间敏感的消息,例如密码重置或事务提醒。

    • 默认发件人 ID-为配置集选择默认发件人 ID。

  6. 选择保存更改

List configuration sets (AWS CLI)

您可以使用describe-configuration-sets命令查看有关您的 Amazon Pinpoint 短信账户中配置集的信息。

要查看您账户中的配置集列表,请使用 AWS CLI
  • 在命令行输入以下命令:

    $ aws pinpoint-sms-voice-v2 describe-configuration-sets
Describe a configuration set (AWS CLI)

您可以使用describe-configuration-sets命令查看有关您的 Amazon Pinpoint 短信账户中配置集的信息。

要查看有关特定配置集的信息,请使用 AWS CLI
  • 在命令行输入以下命令:

    $ aws pinpoint-sms-voice-v2 describe-configuration-sets \ > --configuration-set-names configurationSet

在前面的命令中,将 configurationSet 替换为您要查找其详细信息的配置集的名称。您还可以通过用空格分隔每个配置集的名称来指定多个配置集。

Manage tags (Console)

使用 Amazon Pinpoint 短信控制台添加、编辑或删除标签。

添加标签(控制台)
  1. 打开 Amazon Pinpoint SMS 控制台,网址为:https://console.aws.amazon.com/sms-voice/

  2. 在导航窗格的配置下,选择配置集

  3. 配置集页面上,选择要向其添加标签的配置集。

  4. 标签选项卡上,选择管理标签

    • 添加标签-在 “管理标签” 中,选择 “添加新标签” 以创建新的空白键/值对。

    • 删除标签-在 “管理标签” 中,选择键/值对旁边的 “删除”。

    • 编辑标签-在 “管理标签” 中,选择密钥并编辑文本。

  5. 选择保存更改

Manage tags (AWS CLI)

使用 AWS CLI 添加或编辑标签。

$ aws pinpoint-sms-voice-v2 tag-resource \ --resource-arn resource-arn \ --tags tags={key1=value1,key2=value2}

在上述示例中,执行以下操作:

  • 将 r esource-arn 替换为您想要添加标签的亚马逊资源名称 (ARN)。

  • key1key2 替换为要添加到资源中的标签的键。

  • value1value2 替换为要为相应键添加的标签的值。

使用 AWS CLI 删除标记。

$ aws pinpoint-sms-voice-v2 untag-resource \ --resource-arn resource-arn \ --tag-keys tags={key1=value1,key2=value2}

在上述示例中,执行以下操作:

  • 将 r esource-arn 替换为要从中移除标签的亚马逊资源名称 (ARN)。

  • key1key2 替换为要删除的标签的密钥。

  • value1value2 替换为要删除的标签的值。