更新时间:2024-04-30 GMT+08:00

配置消息通知

您可以在提交媒体处理任务前配置消息订阅,当任务执行完成后,您会收到相关的消息通知。该功能依赖于SMN服务,因此,SMN会根据发送的消息通知数量进行收费,价格详情请参见SMN价格详情

创建消息主题

  1. 登录消息通知服务控制台。
  2. 在左侧导航栏中,选择“主题管理 > 主题”。
  3. 单击右上角“创建主题”。

    弹出“创建主题”对话框。参数配置说明,如表1所示。
    表1 创建主题

    主题信息

    说明

    主题名称

    创建的主题名称,用户可自定义名称,规范如下:

    • 只能包含字母,数字,短横线(-)和下划线(_),且必须由大写字母、小写字母或数字开头。
    • 名称长度限制在1-255字符之间。
    • 主题名称为主题的唯一标识,一旦创建后不能再修改主题名称。

    显示名

    可不填写。推送邮件消息时:

    • 若未设置主题的显示名,发件人呈现为"username@example.com"
    • 若已设置主题的显示名,发件人则呈现为"显示名<username@example.com>"

    企业项目

    企业项目是一种云资源管理方式,企业项目管理服务提供统一的云资源按项目管理,以及项目内的资源管理、成员管理。

    标签

    标签由键值对组成,用于标识云资源,可对云资源进行分类和搜索。

  4. 单击“确定”,主题创建成功。
  5. 单击新建主题行,对应操作列的“添加订阅”,弹出“添加订阅”浮框页面。

    配置消息通知的协议和订阅终端,如图1所示。
    图1 添加订阅

    参数说明如表2所示。

    表2 添加订阅参数说明

    参数

    说明

    主题名称

    待添加订阅的主题名称,不需要修改。

    协议

    消息通知的方式。在下拉框中选择需要订阅终端支持的协议。

    常用的消息通知方式为“短信”“邮件”“HTTP”和“HTTPS”。

    订阅终端

    订阅的终端地址。短信、邮件、HTTP以及HTTPS终端支持批量输入。批量添加时,每个终端地址占一行,最多可输入10个终端。

    • 选择“短信”,请输入有效手机号码。

      输入规则为[+] [国家码][手机号码]。例如:+8600000000000。

      被添加的手机号码会收到由系统发送的“订阅请求”短信,48小时内有效。确认订阅请求后,该手机号码可收到通过该主题发布的所有消息。

    • 选择“邮件”,请输入有效电子邮件地址。例如:username@example.com。

      被添加的邮箱地址会收到由系统发送的“订阅请求”邮件,48小时内有效。确认订阅请求后,该邮箱地址可收到通过该主题发布的所有消息。

    • 选择“HTTP”或“HTTPS”,请输入公网网址,需要确认订阅。例如:https://example.com/notification/action。

      HTTP协议存在安全风险,建议使用HTTPS协议。

  6. 单击“确定”,新增一条订阅信息,可在“主题管理 > 订阅”页面中查看。

    订阅添加完成后,配置的订阅终端将收到确认订阅消息。确认订阅链接在48小时内有效,需要在有效期内完成确认操作。这样设置的订阅终端才能收到该主题发布的消息。

设置主题策略

  1. 访问消息通知服务控制台。
  2. 在左侧导航栏中,选择“主题管理 > 主题”。
  3. 在创建的主题行,单击操作列的“更多 > 设置主题策略”,弹出主题策略设置页面。
  4. 配置主题策略的参数,如图2所示。

    图2 设置主题策略

    设置访问策略为基本模式的主题策略。基本模式只可对用户和服务设置发布消息的操作权限,如图2所示。

    表3 基本模式说明

    策略对象

    参数设置

    说明

    可发布消息的用户

    仅自己(主题创建者)

    仅和主题创建者处于同一个账号下的全部用户拥有权限通过此主题发送消息。

    所有人

    所有用户均有权限向该主题发布消息。

    仅如下用户

    设置可向该主题发布消息的用户。

    格式为urn:csp:iam::domainId:root

    其中,domainId为用户的账号ID。多个用户时,以英文逗号隔开,可输入的用户数量没有限制,但生成的策略总长度不超过30KB。
    说明:
    • 您只需填写用户的“账号ID”,输入完成后,单击“确定”。其余内容由系统自动补全。
    • “账号ID”的获取方式:登录消息通知服务控制台,单击右上角用户名下的“我的凭证”,可查看“账号ID”。

    可发布消息的服务

    例如“MPC”。

    不同区域支持的“可发布消息的服务”不同,具体以管理控制台显示为准。

    勾选“MPC”,表示授权该云服务可对该主题进行操作。

配置消息订阅

  1. 登录媒体处理控制台。
  2. 在左侧导航树中,选择“全局设置 > 消息订阅”,进入消息订阅页面。

    图3 消息订阅

  3. 根据需要勾选订阅事件。
  4. 根据需要勾选订阅消息类型。

    模板消息体说明如模板消息体说明所示,json消息的各字段说明如json消息体说明所示。

    当前配置消息订阅,模板消息以及json消息都勾选时,对于“短信”以及“邮件”订阅协议,只能接收到模板消息,对于“HTTP”以及“HTTPS”订阅协议,只能接收到json消息。

  5. 选择在消息通知服务中配置的消息主题。
  6. 单击“确定”,完成消息订阅配置。

模板消息体说明

  • 转码启用的模板消息内容如下所示。
    尊敬的用户,您的视频转码任务已经启动。任务ID:{task_id},请登录转码Console或调用转码API获取详细转码信息。
  • 转码/截图/转封装/生成动图完成(成功)的模板消息内容如下所示。
     尊敬的用户,您的视频{转码/截图/转封装/生成动图}任务已成功完成。任务ID:{task_id},请登录转码Console或调用转码API获取详细转码信息。
  • 转码/截图/转封装/生成动图完成(失败)的模板消息内容如下所示。
    尊敬的用户,您的视频{转码/截图/转封装/生成动图}任务处理时出现错误。任务ID:{task_id},错误码:{err_code},错误信息:{err_msg}。