检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
绑定云日志 功能介绍 为指定Topic绑定一个云日志,用于记录主题消息发送状态等信息。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/notifications/topics/{topic_urn}/logtanks 表1 路径参数 参数 是否必选
更新消息模板 功能介绍 修改消息模板的内容。 调用方法 请参见如何调用API。 URI PUT /v2/{project_id}/notifications/message_template/{message_template_id} 表1 路径参数 参数 是否必选 参数类型 描述
更新主题 功能介绍 更新显示名。 调用方法 请参见如何调用API。 URI PUT /v2/{project_id}/notifications/topics/{topic_urn} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取项目ID请参考
删除资源标签 功能介绍 幂等接口:删除时,不对标签做校验。删除的key不存在报404,key不能为空或者空字符串。 调用方法 请参见如何调用API。 URI DELETE /v2/{project_id}/{resource_type}/{resource_id}/tags/{key}
批量更新订阅过滤策略 功能介绍 更新订阅者的消息过滤策略。 调用方法 请参见如何调用API。 URI PUT /v2/{project_id}/notifications/subscriptions/filter_polices 表1 路径参数 参数 是否必选 参数类型 描述 project_id
分页查询Topic列表,Topic列表按照Topic创建时间进行降序排列。分页查询可以指定offset以及limit。如果不存在Topic,则返回空列表。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/notifications/topics 表1 路径参数 参数 是否必选
多协议通知 使用消息通知服务,只需要通过一次发布请求,就能向各种协议的订阅者推送消息。 业务需要发送电子邮件、短信、FunctionGraph(函数)或者进行HTTP(S)推送,开发多种协议的消息收发系统,周期长。 安全 消息通知服务数据安全是基于Topic进行安全隔离,用户未经授权不能访问队列消息,有效保护用户业务安全。
添加资源标签 功能介绍 一个资源上最多有10个标签。此接口为幂等接口:创建时,如果创建的标签已经存在(key相同),则覆盖。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/{resource_type}/{resource_id}/tags
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 响应参数 状态码: 200 表3 响应Body参数
创建时,不允许重复key,如果数据库存在就覆盖。 删除时,如果删除的标签不存在,默认处理成功,删除时不对标签字符集范围做校验。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/{resource_type}/{resource_id}/tags/action
在熟悉了SMN的基本概念之后,您可以通过消息通知服务的管理控制台进行基本主题订阅操作;同时您还可以直接在应用程序中进行RESTful API调用执行相应的操作。 选择消息发布类型 消息通知服务在不同的使用场景下,可以选择不同的发布消息类型,请参见表1。 表1 发布消息类型 消息类型
使用模板格式发送消息时,需要选择模板名称,名称选定后,系统会按照Default、SMS、Email、HTTP、HTTPS、FunctionGraph(函数)、FunctionGraph(工作流)的协议顺序,将该模板名称下不同协议的所有模板内容中的{tag}标签列出,重复的{tag}只列出一次
交流的通道。 订阅是您将订阅者注册到主题的操作。要接收发布至主题的消息,您必须订阅一个订阅终端到该主题。终端节点可以是手机号码、邮件地址、函数、平台应用的终端、DMS或HTTP(S)终端。为终端节点订阅主题且确认订阅后,终端节点能够接收到向该主题发布的所有消息。 商用 主题管理 订阅管理
删除主题 订阅管理 订阅是您将订阅者注册到主题的操作。要接收发布至主题的消息,您必须订阅一个订阅终端到该主题。终端节点可以是手机号码、邮箱地址、函数或HTTP(S)终端。为终端节点订阅主题且确认订阅后,终端节点能够接收到向该主题发布的所有消息。 您可以拥有多个主题,每个主题有多个订阅者
订阅确认流控说明 为了控制用户对订阅者进行恶意的攻击,云平台对添加订阅时发送订阅确认消息进行了流控。流控策略既适用于从控制台发送订阅确认消息也适用于通过调用API发送订阅确认消息。 根据不同的协议有不同的流控策略: 对于一个邮件订阅者,1个小时最多允许发送20次订阅确认消息,2天最多允许发送4
当“类型”取值为“协议”时,在下拉框中选择需要限定消息发布的协议类型,提供的选项为“短信”、“邮件”、“HTTP”、“HTTPS”、“FunctionGraph(函数)”、“FunctionGraph(工作流)。 当“类型”取值为“String Array”时,值必须为字符串数组,数组长度至少为1且不能超过10。
设置选择该模板推送消息时的接收终端类型,模板一旦选定不能再修改。 取值范围为:Default、短信、邮件、HTTP、HTTPS、FunctionGraph(函数)、FunctionGraph(工作流)。 协议默认为“Default”。如果用户不选择协议,则使用默认值。 模板内容 用户可自定义模板内容。
账号具备所有接口的调用权限,如果使用账号下的IAM用户发起API请求时,该IAM用户必须具备调用该接口所需的权限,否则,API请求将调用失败。每个接口所需要的权限,与各个接口所对应的授权项相对应,只有发起请求的用户被授予授权项所对应的策略,该用户才能成功调用该接口。例如,用户要调用接口来查
查询、删除、更新等。支持的全部操作请参见API概览。 在调用消息通知服务API之前,请确保已经充分了解消息通知服务相关概念,详细信息请参见《消息通知服务用户指南》的“产品介绍”。 终端节点 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以
附录 JSON格式消息说明 模板格式消息说明 不同协议消息说明 订阅确认流控说明 国家(或地区)码 授权操作与SMN接口的映射关系 短信发送限制 HTTP(S)终端节点使用样例 订阅筛选策略使用样例