检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本节定义了消息通知服务上报云监控的监控指标的命名空间,监控指标列表,各项监控指标的具体含义与使用说明,用户可以通过云监控检索消息通知服务产生的监控指标和告警信息。 命名空间 SYS.SMN 监控指标 消息通知服务支持的监控指标如表1所示。 表1 消息通知服务支持的监控指标 指标ID 指标名称
查询主题列表 功能介绍 分页查询Topic列表,Topic列表按照Topic创建时间进行降序排列。分页查询可以指定offset以及limit。如果不存在Topic,则返回空列表。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/notifications/topics
查询订阅者列表 功能介绍 分页返回请求者的所有的订阅列表,订阅列表按照订阅创建时间进行升序排列。分页查询可以指定offset以及limit。如果订阅者不存在,返回空列表。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/notifications/subscriptions
查询消息模板列表 功能介绍 分页查询模板列表,模板列表按照创建时间进行升序排列。分页查询可以指定offset以及limit。如果不存在模板,则返回空列表。额外的查询参数分别有message_template_name和protocol。 调用方法 请参见如何调用API。 URI GET
当SMN服务向HTTP(S)终端发送消息时,头部包括请求X-SMN-MESSAGE-TYPE,X-SMN-MESSAGE-ID,X-SMN-TOPIC-URN,如表1所示。 表1 消息HTTP(S)头部参数说明 参数 说明 X-SMN-MESSAGE-TYPE 消息类型,消息类型分别有: SubscriptionConfirmation
查询指定Topic的订阅者列表 功能介绍 分页获取特定Topic的订阅列表,订阅列表按照订阅创建时间进行升序排列。分页查询可以指定offset以及limit。如果指定Topic不存在订阅者,返回空列表。 调用方法 请参见如何调用API。 URI GET /v2/{project_
录的情况下调用Unsubscribe,这种情况下您的取消订阅操作则不会被云审计记录。 云审计支持的消息通知服务操作列表如表1所示。 表1 云审计支持的SMN操作列表 操作名称 资源类型 事件名称 创建主题 topic createTopic 删除主题 topic deleteTopic
查询Application的Endpoint列表(废弃) 功能介绍 查询平台的endpoint列表。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v2/
基于网络安全考虑,SMN默认不支持使用华为云内网地址接收消息。 消息通知服务SMN对某些具体指标进行了约束和规范,您在使用时注意不要超过相应的限制值,以免程序出现异常。 针对主题的限制项和限制值请参见表1。 表1 主题限制项及限制值 限制项 限制值 说明 主题名称 1-255字符 超过该限制,主题无法创建。
在“模板名称”框中,输入模板名称,选择所使用的“协议”,在“模板内容”框中输入模板内容,参数说明如表1所示。 表1 创建消息模板参数说明 参数 说明 模板名称 创建的模板名称,用户可自定义名称,规范如下: 只能包含字母,数字,短横线(-)和下划线(_),只能以字母或数字开头。 名称长度限制在1-64字符之间。
在主题页面,单击“创建主题”。 图1 创建主题 在“主题名称”框中,输入主题名称,在“显示名”框中输入相关描述,如表1所示。 表1 创建主题参数说明 参数 说明 主题名称 创建的主题名称,用户可自定义名称,规范如下: 只能包含字母,数字,短横线(-)和下划线(_),且必须由大写字母、小写字母或数字开头。
在主题列表中,选择您要向其发布消息的主题,在右侧“操作”栏单击“发布消息”。 或者单击“主题名称”,在主题详情页中,单击右上角的“发布消息”按钮。 在弹出的发布消息对话框中,主题名称为已选择的需要发布消息的主题名称,不可修改。其它参数根据界面提示填写。填写说明请参考表1。 表1 发布消息参数说明
生成的消息内容显示模板名称和所有{tag}标签。如图4所示。 图4 模板消息范例 (可选)根据界面提示,配置消息属性参数。消息属性用于限定消息发布范围,填写说明如表1所示。 表1 消息属性参数说明 参数 说明 类型 选择需要限定发布消息的类型。 协议 String Array String 名称 名称只能由数
此时将显示“添加订阅”对话框。 图1 添加订阅 在“协议”下拉框中选择您需要的协议,在“订阅终端”输入框中输入对应的订阅终端,填写说明如表1所示。 表1 添加订阅参数说明 参数 说明 主题名称 在弹出的对话框中选择的主题的名称。 协议 在下拉框中选择需要订阅终端支持的协议,提供的选项为“
attributes 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取项目ID请参考 获取项目ID。 topic_urn 是 String Topic的唯一的资源标识,可通过查询主题列表获取该标识。 表2 Query参数 参数
单击按钮,可以自定义事件列表的展示信息。启用表格内容折行开关,可让表格内容自动折行,禁用此功能将会截断文本,默认停用此开关。 关于事件结构的关键字段详解,请参见事件结构和事件样例。 (可选)在新版事件列表页面,单击右上方的“返回旧版”按钮,可切换至旧版事件列表页面。 在旧版事件列表查看审计事件
SDK列表 在开始使用之前,请确保您安装的是最新版本的SDK。使用过时的版本可能会导致兼容性问题或无法使用最新功能。您可以在SDK中心查询版本信息。 表1提供了SMN服务支持的SDK列表,您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表
attributes object 属性列表。 表4 attributes 参数 参数类型 描述 enabled String 设备是否可用。 token String 设备token。 user_data String 用户数据。 状态码: 400 表5 响应Body参数 参数 参数类型
产品优势 对比其他传统消息中间件组件,消息通知服务的核心优势如表1所示。 表1 产品优势 核心优势 消息通知服务 传统消息中间件 服务简便 直接使用消息通知服务,只需要使用三个简单的API (创建Topic、订阅Topic、发送消息),就能够快速高效的发送消息,使用门槛极低,快速融入业务使用。
华为云消息通知服务仅按实际用量付费,没有最低消费。 计费项 华为云消息通知服务对消息通知费用、外网下行流量计费,具体的计费详情请参见价格详情。 表1 计费项说明 计费项 计费说明 消息通知 SMS:统计每月每个区域每个主题的发送条数,按数量收费。短信条数计算规则请参考《消息&短信服务产品介绍》中“内容长度计算规则”章节。