检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 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
基于网络安全考虑,SMN默认不支持使用华为云内网地址接收消息。 消息通知服务SMN对某些具体指标进行了约束和规范,您在使用时注意不要超过相应的限制值,以免程序出现异常。 针对主题的限制项和限制值请参见表1。 表1 主题限制项及限制值 限制项 限制值 说明 主题名称 1-255字符 超过该限制,主题无法创建。
查询Application的Endpoint列表(废弃) 功能介绍 查询平台的endpoint列表。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v2/
在“模板名称”框中,输入模板名称,选择所使用的“协议”,在“模板内容”框中输入模板内容,参数说明如表1所示。 表1 创建消息模板参数说明 参数 说明 模板名称 创建的模板名称,用户可自定义名称,规范如下: 只能包含字母,数字,短横线(-)和下划线(_),只能以字母或数字开头。 名称长度限制在1-64字符之间。
在主题页面,单击“创建主题”。 图1 创建主题 在“主题名称”框中,输入主题名称,在“显示名”框中输入相关描述,如表1所示。 表1 创建主题参数说明 参数 说明 主题名称 创建的主题名称,用户可自定义名称,规范如下: 只能包含字母,数字,短横线(-)和下划线(_),且必须由大写字母、小写字母或数字开头。
在主题列表中,选择您要向其发布消息的主题,在右侧“操作”栏单击“发布消息”。 或者单击“主题名称”,在主题详情页中,单击右上角的“发布消息”按钮。 在弹出的发布消息对话框中,主题名称为已选择的需要发布消息的主题名称,不可修改。其它参数根据界面提示填写。填写说明请参考表1。 表1 发布消息参数说明
生成的消息内容显示模板名称和所有{tag}标签。如图4所示。 图4 模板消息范例 (可选)根据界面提示,配置消息属性参数。消息属性用于限定消息发布范围,填写说明如表1所示。 表1 消息属性参数说明 参数 说明 类型 选择需要限定发布消息的类型。 协议 String Array String 名称 名称只能由数
attributes 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取项目ID请参考 获取项目ID。 topic_urn 是 String Topic的唯一的资源标识,可通过查询主题列表获取该标识。 表2 Query参数 参数
此时将显示“添加订阅”对话框。 图1 添加订阅 在“协议”下拉框中选择您需要的协议,在“订阅终端”输入框中输入对应的订阅终端,填写说明如表1所示。 表1 添加订阅参数说明 参数 说明 主题名称 在弹出的对话框中选择的主题的名称。 协议 在下拉框中选择需要订阅终端支持的协议,提供的选项为“
单击按钮,可以自定义事件列表的展示信息。启用表格内容折行开关,可让表格内容自动折行,禁用此功能将会截断文本,默认停用此开关。 关于事件结构的关键字段详解,请参见事件结构和事件样例。 (可选)在新版事件列表页面,单击右上方的“返回旧版”按钮,可切换至旧版事件列表页面。 在旧版事件列表查看审计事件
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:统计每月每个区域每个主题的发送条数,按数量收费。短信条数计算规则请参考《消息&短信服务产品介绍》中“内容长度计算规则”章节。