检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 通过使用消息通知服务所提供的接口,您可以完整的使用消息通知服务的所有功能。例如创建Topic、添加订阅。 表1 接口说明 类型 说明 主题操作 包含创建主题、更新主题、删除主题等接口。 订阅操作 包含查询订阅列表、订阅、取消订阅等接口。 模板操作 包含创建消息模板、更新消息模板、删除消息模板等接口。
请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 value 是 String
}/tags/action 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取项目ID请参考 获取项目ID。 resource_type 是 String 资源类型,目前有: smn_topic,主题 smn_sms,短信 smn_application,移动推送
application消息体格式(废弃) 表1 application消息体格式 类型 样例 备注 华为透传消息 "hps": { "msg" : { "type" : 1, "body" : {"key":"value"} } } body为用户自定义格式。 说明: 推荐使用JSON格式,如样例所示
约束与限制 当您通过消息通知服务SMN发送邮件、短信等消息时,您需要确保传输的内容符合当地法律法规要求。 SMN使用异步方式推送消息,不保证消息送达的时效性。如果业务要求消息准实时送达,请慎重考虑是否使用SMN服务。 SMN服务发送消息的邮箱地址和发送短信/语音的号码地址不固定,
Endpoint在同一个区域也相同,所以简洁起见将这两部分省略。 请求方法 HTTP请求方法(也称为操作或动词),它告诉服务您正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。
请参见权限管理。 主题策略: 主题创建者拥有设置主题访问策略的权限。通过主题策略的设置,您可授权或拒绝云服务或其他用户对主题资源进行特定类型操作,如查询主题详情、发布消息等。授权其他用户后,主题创建者依然可以操作该主题。 详情请参见主题策略。 父主题: 安全
情况下您的取消订阅操作则不会被云审计记录。 云审计支持的消息通知服务操作列表如表1所示。 表1 云审计支持的SMN操作列表 操作名称 资源类型 事件名称 创建主题 topic createTopic 删除主题 topic deleteTopic 更新主题 topic updateTopic
示例2:使用消息模板方式发布消息 操作场景 本章节指导用户通过API使用消息模板方式发布消息。API的调用方法请参见如何调用API。 涉及接口 获取用户Token:通过用户名/密码的方式进行认证来获取IAM用户Token。 创建主题:创建Topic。 订阅:为指定Topic添加订阅者。
只能包含字母,数字,短横线(-)和下划线(_),只能以字母或数字开头。 名称长度限制在1-64字符之间。 一旦创建后不能再修改。 协议 设置选择该模板推送消息时的接收终端类型,模板一旦选定不能再修改。 取值范围为:Default、短信、邮件、HTTP、HTTPS、FunctionGraph(函数)、FunctionGraph(工作流)。
主题管理 创建主题 设置主题策略 订阅主题 发布主题消息 订阅管理 添加订阅 请求订阅 消息模板管理 创建消息模板 02 入门 针对不同消息类型的端到端配置指导,帮助您快速上手使用消息通知服务。 配置指导 通过SMN发布JSON消息 通过SMN发布模板消息 04 API 通过SMN
通知服务接口参考》中“策略及授权项说明”章节。 如表1所示,包括了SMN的所有系统权限。 表1 SMN系统权限 系统角色/策略名称 描述 类别 依赖关系 SMN Administrator 消息通知服务的管理员权限,拥有该权限的用户拥有消息通知服务所有执行权限。 系统角色 依赖Tenant