检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
附录 JSON格式消息说明 模板格式消息说明 不同协议消息说明 订阅确认流控说明 国家(或地区)码 授权操作与SMN接口的映射关系 短信发送限制 HTTP(S)终端节点使用样例 订阅筛选策略使用样例
通过SMN发布JSON消息 操作场景 消息通知服务能够根据用户的需求,向订阅终端主动推送消息。消息通知服务支持发布JSON消息,可通过一次消息发布,向不同类型的订阅者发布不同内容的消息。 本章节以创建主题并发布JSON消息为例,指导您快速上手消息通知服务。 操作流程 操作步骤 说明
} } 在消息内容输入框中手动输入模板格式的消息,或通过单击“生成模板消息”自动生成消息。 模板格式的消息描述,请参见模板格式消息说明。 单击“确定”,消息将推送至不同的订阅终端。 各个终端接收到的消息内容说明请参考“不同协议消息说明”部分。 步骤五:接收消息 在订阅主题时,
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 响应参数 状态码: 400 表3 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。
发送状态 发送状态描述 DELIVRD 用户已成功收到短信。 EXPIRED 短信已超时。 DELETED 短信已删除。 UNDELIV 短信递送失败。 ACCEPTD 短信已接收。 UNKNOWN 短信状态未知。 REJECTD 短信被拒绝。 父主题: 附录
smn_topic,主题 smn_sms,短信 smn_application,移动推送 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。
单个主题支持多种传输协议定义,目前支持HTTP/HTTPS、邮件、FunctionGraph(函数)、FunctionGraph(工作流)以及短信传输协议。
什么是消息通知服务 消息通知服务(Simple Message Notification,SMN)是可靠的、可扩展的、海量的消息处理服务。它可以依据用户的需求主动推送通知消息,最终用户可以通过短信、电子邮件等方式接收。 图1 SMN产品架构 SMN的主题订阅模型,旨在提供一对多的
参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 tags Array of ResourceTag
消息传输日志 操作场景 如果您想了解您发布至主题的消息的发送情况,您可以使用消息传输日志功能。该功能支持查看短信、邮件、FunctionGraph(函数)、FunctionGraph(工作流)、HTTP、HTTPS等协议的消息发送情况。配置消息传输日志时需要您对接云日志服务,并且
删除模板 发布主题消息 消息通知服务提供了以下三种通用的方式。 发布文本格式的消息。 发布JSON格式的消息。 发布模板格式的消息。 一旦一条新的消息已经发布,消息通知服务试图将消息发布至每个已经向主题确认订阅的终端节点。 如果使用短信协议接收消息,对于内容很长的消息,短信长度限制为4
不同协议消息说明 不同的订阅协议接收到的消息包含的内容可能有所不同。 邮件和HTTP(S)终端收到的消息包含:消息主题、消息内容和取消订阅的链接。 短信终端接收到的消息只包含消息内容。 FunctionGraph(函数)终端收到的消息包含消息属性、消息标题、消息内容、主题URN等
access_policy Topic资源的访问策略,控制其他用户访问该Topic的权限。 空字符串。 introduction 在邮件和短信订阅确认信息中展示Topic的介绍,使您能够让订阅者对主题有更多的了解。 空字符串。 父主题: 附录
创建消息模板 功能介绍 创建一个模板,用户可以按照模板去发送消息,这样可以减少请求的数据量。 单用户默认可创建100个消息模板,高并发场景下,可能会出现消息模板数量超过100仍创建成功的情况,此为正常现象。 调用方法 请参见如何调用API。 URI POST /v2/{proje
产品优势 对比其他传统消息中间件组件,消息通知服务的核心优势如表1所示。 表1 产品优势 核心优势 消息通知服务 传统消息中间件 服务简便 直接使用消息通知服务,只需要使用三个简单的API (创建Topic、订阅Topic、发送消息),就能够快速高效的发送消息,使用门槛极低,快速融入业务使用。
是否操作正确。 消息模板 消息模板指消息内容的固定格式。发布消息时可以使用已创建的消息模板生成模板消息。如果消息模板中存在模板变量,生成模板消息时系统会将模板变量自动替换为用户设置的参数值。 模板变量 创建消息模板时,在消息模板里设置的变量。在使用消息模板发送消息时,可以使用参数值来替换此变量。
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 protocol 是 String 不同协议对应不同的endpoint(接受消息的接入点)。 目前支持的协议包括:
服务韧性 为避免个别客户大量发送消息,影响消息通知服务对整体客户的服务能力,消息通知服务对消息发送有下列限制,超过限制将不可发送消息。 主题流控 针对单个主题的流控,不区分协议类型,控制该主题消息的并发量,统计周期固定1分钟,默认3k/分钟。 租户短信流控 针对单个租户一定周期内
添加资源标签 功能介绍 一个资源上最多有10个标签。此接口为幂等接口:创建时,如果创建的标签已经存在(key相同),则覆盖。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/{resource_type}/{resource_id}/tags
请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 request_id