检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SMN将为该主题分配唯一的URN,其中包括服务名称(SMN)、区域名称、项目ID和主题名称。URN将作为创建主题时使用的API调用的一部分返回。无论何时发布者或者订阅者需要对该主题执行任何操作,都应引用该唯一主题URN。
SMN不支持发往中国大陆手机号码的短信内容中使用【】等特殊字符。详细信息请参见《消息&短信服务用户指南》的模板规范和变量规范包含哪些内容?章节。
删除的key不存在报404,key不能为空或者空字符串。 调用方法 请参见如何调用API。
URN URN是SMN用来标识资源的字符串,目前存在以下几种类型。 主题URN 创建主题后,SMN将为该主题分配的唯一资源标识,其中包括服务名称(SMN)、区域名称、项目ID和主题名称。
创建签名字符串。将消息中的键值对取出来,使其键值按字典序排序。每一个键占一行,每一个值占一行,键所对应的值在该键所占行的下一行。
删除时tags结构体不能缺失,key不能为空或空字符串,且不针对字符集范围进行校验。 action 是 String 操作标识:仅限于create(创建)、delete(删除)。
HTTP(S)消息格式 操作场景 接收SMN服务发送的HTTP(S)消息时,终端证书的CN名称请参考业界规范,部分特殊字符可能导致https消息发送失败。 在互联网上传递未加密的http协议消息内容存在信息泄漏风险,推荐用户终端添加订阅时对接通道优先使用https类型。
键的长度最大128字符,值的长度最大255字符。 标签的键可以包含任意语种的字母、数字和空格,以及_.:=+-@字符,但首尾不能包含空格,且不能以_sys_开头。 标签的值可以包含任意语种字母、数字、空格和_ . : / = + - @。 每个主题最多可创建20个标签。
platform_principal 是 String 对于HMS平台是APP ID,只能包含英文字母和数字,最大20个字符。 对于苹果APNS、APNS_SandBox平台是推送证书,大小不超过8K,且是Base64编码。
当“类型”取值为“String”时,输入限定发布消息的字符串名称。
SMN支持添加飞书域名(open.feishu.cn)和lark域名(open.larksuite.com)的地址作为订阅终端。 企业微信机器人 在企业微信群设置中选择群机器人,单击右上角的“添加”,创建成功后,即可获取webhook地址。
表3 请求Body参数 参数 是否必选 参数类型 描述 platform_principal 是 String 对于HMS平台是APP ID,只能包含英文字母和数字,最大20个字符。
若请求消息体中的参数支持中文,则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。
不同协议消息说明 不同的订阅协议接收到的消息包含的内容可能有所不同。 邮件和HTTP(S)终端收到的消息包含:消息主题、消息内容和取消订阅的链接。 短信终端接收到的消息只包含消息内容。
表1 创建消息模板参数说明 参数 说明 模板名称 创建的模板名称,用户可自定义名称,规范如下: 只能包含字母,数字,短横线(-)和下划线(_),只能以字母或数字开头。 名称长度限制在1-64字符之间。 一旦创建后不能再修改。
当“类型”取值为“String”时,输入限定发布消息的字符串名称。
空字符串。 introduction 在邮件和短信订阅确认信息中展示Topic的介绍,使您能够让订阅者对主题有更多的了解。 空字符串。 父主题: 附录
“HTTP”、“HTTPS”: 消息以HTTP/HTTPS请求的形式发送到订阅的URL,目前只支持公网域名或者公网IP地址。 “FunctionGraph(函数)”:使用已发布的消息的负载调用订阅的FunctionGraph(函数)终端。
not_tags_any 否 Array of ResourceTags objects 最多包含10个key,每个key最多包含10个value,结构体不能缺失。key不能为空或者空字符串。
标签的值长度 256字符 超过该限制,标签无法创建。 发布文本消息标题 512字节 无 发布文本消息内容 256KB 如果消息超过1000个字符,系统向短信订阅者发送消息时,因运营商限制可能会发送失败。