# SMN消息通知 如果消息通知使用SMN服务，SMN将对发送的消息通知单独计费，具体的计费标准请参考[SMN产品价格详情](https://www.huaweicloud.com/pricing/calculator.html#/smn)。 #### 注意事项 根据中国境内法律法规要求，如果短信包含链接（含短链）、域名、任何形式的联系方式等信息，可能被运营商拦截，导致短信发送失败，须参考[SMN通知](https://www.huaweicloud.com/notice/2025/20250628143556673.html)处理。 #### 功能介绍 - 主题是消息发布或客户端订阅通知的特定事件类型。它作为发送消息和订阅通知的信道，为发布者和订阅者提供一个可以相互交流的通道。在配置点播消息订阅前必须定制主题。 - 点播消息通知包括"转码完成"、"截图完成"、"审核完成"、"创建完成"、"音频提取完成"、"封面生成完成"几类。消息订阅是客户将订阅者注册到主题的操作，客户可以拥有多个主题，每个主题有多个订阅者。 #### 配置流程 消息订阅的配置流程，如[图1]所示。 图1消息订阅配置流程图 ![](https://support.huaweicloud.com/usermanual-vod/zh-cn_image_0000001721925833.png) 1. [创建消息主题]：在消息通知服务控制台新建消息主题，用于消息发送和订阅通知。 2. [设置主题策略]：授权点播服务可对该主题发布消息。 3. [配置点播消息订阅]：在点播控制台配置消息订阅，即可在转码、截图、审核等操作时接收到消息通知。 #### 创建消息主题 1. 登录[SMN控制台](https://console.huaweicloud.com/smn/#/dashboard)。 2. 在左侧导航栏中，选择"主题管理 \> 主题"。 3. 单击右上角"创建主题"。 弹出"创建主题"对话框。参数配置说明，如[表1]所示。 表1创建主题 | 主题信息 | 说明 | |:---|:---| | 主题名称 | 创建的主题名称，用户可自定义名称，规范如下： - 只能包含字母，数字，短横线(-)和下划线(_)，且必须由大写字母、小写字母或数字开头。 - 名称长度限制在1-255字符之间。 - 主题名称为主题的唯一标识，一旦创建后不能再修改主题名称。 | | 显示名 | 可不填写。推送邮件消息时： - 若未设置主题的显示名，发件人呈现为"username@example.com" - 若已设置主题的显示名，发件人则呈现为"显示名\" | | 企业项目 | 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。 | | 标签 | 标签由键值对组成，用于标识云资源，可对云资源进行分类和搜索。 | 4. 单击"确定"，主题创建成功。 5. 单击新建主题行，对应"操作"列的"添加订阅"，弹出"添加订阅"浮框页面。 配置消息通知的协议和订阅终端，参数说明如[表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. 访问[SMN控制台](https://console.huaweicloud.com/smn/#/dashboard)。 2. 在左侧导航栏中，选择"主题管理 \> 主题"。 3. 在创建的主题行，单击"操作"列的"更多 \> 设置主题策略"，弹出"设置主题策略"页面。 设置访问策略为基本模式的主题策略。基本模式为只可对用户和服务，设置发布消息的操作权限，详细说明如[表3]所示。 表3基本模式说明 | 策略对象 | 参数设置 | 说明 | |:---|:---|:---| | 可发布消息的用户 | 仅自己（主题创建者） | 仅和主题创建者处于同一个账号下的全部用户拥有权限通过此主题发送消息。 | | 可发布消息的用户 | 所有人 | 所有用户均有权限向该主题发布消息。 | | 可发布消息的用户 | 仅如下用户 | 设置可向该主题发布消息的用户。 格式为urn:csp:iam::domainId:root 其中，domainId即为用户的账号ID。多个用户时，以英文逗号隔开，可输入的用户数量没有限制，但生成的策略总长度不超过30KB。 说明： - 您只需填写用户的"账号ID"，输入完成后，单击"确定"。其余内容由系统自动补全。 - "账号ID"的获取方式：登录[SMN控制台](https://console.huaweicloud.com/smn/#/dashboard)，单击右上角用户名下的"我的凭证"，可查看"账号ID"。 | | 可发布消息的服务 | 例如"VOD"。 不同区域支持的"可发布消息的服务"不同，具体以管理控制台显示为准。 | 勾选"VOD"，表示授权该云服务可对该主题进行操作。 | #### 配置点播消息订阅 1. 登录[视频点播控制台](https://console.huaweicloud.com/vod2/#/vod/home)。 2. 在左侧导航树中选择"全局设置 \> 消息订阅"，进入消息订阅页签。 图2配置消息订阅 ![](https://support.huaweicloud.com/usermanual-vod/zh-cn_image_0000001674046394.png) 3. 根据需要勾选订阅事件。 ![](https://support.huaweicloud.com/usermanual-vod/public_sys-resources/notice_3.0-zh-cn.png) 如果用户同时勾选"截图完成事件"和"封面生成完成事件"，不会触发封面通知，都只会触发截图通知。 4. 根据需要勾选订阅消息类型。 ![](https://support.huaweicloud.com/usermanual-vod/public_sys-resources/note_3.0-zh-cn.png) 若消息类型"模板消息"和"json消息"都勾选，则对于"短信"以及"邮件"订阅协议，只能接收到模板消息，对于"HTTP"以及"HTTPS"订阅协议，只能接收到json消息。 - 勾选"接收模板消息"，模板消息内容请参考[表4 模板消息说明]。**通知文本消息内容** 中的各变量参数与实际操作相关，请以实际收到的消息内容为准。 表4模板消息说明 | 事件 | 事件处理结果状态 | 通知文本消息内容 | |:---|:---|:---| | 转码完成 | 成功 | 尊敬的用户，您的视频转码任务已成功完成。视频ID：{asset_id}，名称：{title}，请登录点播Console或调用点播API获取详细转码信息。 | | 转码完成 | 失败 | 尊敬的用户，您的视频转码任务处理时出现错误。视频ID：{asset_id}，名称：{title}，错误码：{err_code}，错误信息：{err_msg}。 | | 截图完成 | 成功 | 尊敬的用户，您的视频截图任务已成功完成。视频ID：{asset_id}，名称：{title}，请登录点播Console或调用点播API获取详细截图信息。 | | 截图完成 | 失败 | 尊敬的用户，您的视频截图任务处理时出现错误。视频ID：{asset_id}，名称：{title}，错误码：{err_code}，错误信息：{err_msg}。 | | 审核完成 | 成功 | 尊敬的用户，您的视频审核任务已成功完成。视频ID：{asset_id}，名称：{title}，审核建议：{suggestion}，请登录点播Console或调用点播API获取详细审核信息。 | | 审核完成 | 失败 | 尊敬的用户，您的视频审核任务处理时出现错误。视频ID：{asset_id}，名称：{title}，错误码：{err_code}，错误信息：{err_msg}。 | | 媒资创建完成 | 成功 | 尊敬的用户，您的视频创建完成。视频ID：{asset_id}，视频名称：{title}，请登录点播Console或调用点播API获取详细视频信息。 | | 媒资创建完成 | 失败 | 尊敬的用户，您的视频创建时出现错误。视频ID：{asset_id}，视频名称：{title}，错误码：{err_code}，错误信息：{err_msg}。 | | 音频提取完成 | 成功 | 尊敬的用户，您的音频提取完成。音频ID：{asset_id}，音频名称：{title}，请登录点播Console或调用点播API获取详细音频信息。 | | 音频提取完成 | 失败 | 尊敬的用户，您的音频提取时出现错误。音频ID：{asset_id}，音频名称：{title}，错误码：{err_code}，错误信息：{err_msg}。 | | 封面生成完成 | 成功 | 尊敬的用户，您的视频封面已生成。视频ID：{asset_id}，视频名称：{title}，请登录点播Console或调用点播API获取详细视频信息。 | | 封面生成完成 | 失败 | 尊敬的用户，您的视频封面生成失败。视频ID：{asset_id}，视频名称：{title}，错误码：{err_code}，错误信息：{err_msg}。 | | 媒资解析完成 | 成功 | 尊敬的用户，您的视频解析完成。视频ID：{asset_id}，视频名称：{title}，请登录点播Console或调用点播API获取详细视频信息。 | | 媒资解析完成 | 失败 | 尊敬的用户，您的视频解析时出现错误。视频ID：{asset_id}，视频名称：{title}，错误码：{err_code}，错误信息：{err_msg}。 | | 媒资编辑完成 | 成功 | 尊敬的用户，您的编辑任务已完成。视频ID：{assetId}，视频名称：{title}，请登录点播Console或调用点播API获取详细视频信息。 | | 媒资编辑完成 | 失败 | 尊敬的用户，您的编辑任务处理时出现错误。视频ID：{assetId}，错误码：{err_code}，错误信息：{err_msg}。 | - 勾选"接收json消息"，消息模板请参考[表5 json消息模板说明]。 表5json消息模板说明 | 参数 | 说明 | 类型 | |:---|:---|:---| | event_type | 事件类型，当前支持的取值如下： - transcodeComplete：转码（加密）完成 - thumbnailComplete：截图完成 - reviewComplete：审核完成 - createComplete：媒资创建完成 - audioExtractComplete：音频提取完成 - coverComplete：封面生成完成 - parseComplete：媒资解析完成 - editComplete：媒资编辑完成 | String | | transcode_info | 转码（含加密）信息，仅当是转码（加密）事件才有该字段，具体消息说明请参考[转码消息体](https://support.huaweicloud.com/usermanual-vod/vod_01_0048.html)。 | TranscodeInfo | | thumbnail_info | 截图信息，仅当是截图事件才有该字段，具体消息说明请参考[截图消息体](https://support.huaweicloud.com/usermanual-vod/vod_01_0049.html)。 | ThumbnailInfo | | review_info | 审核信息，仅当是审核事件才有该字段，具体消息说明请参考[审核消息体](https://support.huaweicloud.com/usermanual-vod/vod_01_0050.html)。 | ReviewInfo | | create_info | 新创建的媒资信息，仅当是媒资创建事件才有该字段，具体消息说明请参考[创建媒资\&音频提取消息体](https://support.huaweicloud.com/usermanual-vod/vod_01_0053.html)。 | AssetInfo | | audio_extract_info | 新提取的音频信息，仅当是音频提取事件才有该字段，具体消息说明请参考[创建媒资\&音频提取消息体](https://support.huaweicloud.com/usermanual-vod/vod_01_0053.html)。 | AssetInfo | | cover_info | 封面生成消息，仅当是封面生成事件才有该字段，具体消息说明请参考[封面生成消息体](https://support.huaweicloud.com/usermanual-vod/vod_01_0054.html)。 | CoverInfo | | parse_info | 媒资解析完成消息，仅当是媒资解析完成事件才有该字段，具体消息说明请参考[解析媒资消息体](https://support.huaweicloud.com/usermanual-vod/vod_01_0093.html)。 | ParseInfo | | edit_info | 媒资编辑完成消息，仅当是编辑完成事件才有该字段，具体消息说明请参考[编辑媒资消息体](https://support.huaweicloud.com/usermanual-vod/vod_01_0098.html)。 | ParseInfo | 5. 勾选在消息通知服务创建的SMN主题。 6. 单击"确定"，完成消息订阅配置。