检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 通过使用消息通知服务所提供的接口，您可以完整的使用消息通知服务的所有功能。例如创建Topic、添加订阅。 表1 接口说明 类型 说明 主题操作 包含创建主题、更新主题、删除主题等接口。 订阅操作 包含查询订阅列表、订阅、取消订阅等接口。 模板操作 包含创建消息模板、更新消息模板、删除消息模板等接口。
app-APNS-application_name002", "application_id" : "a3a4643dc12b4g77ad6e35a16002558c" } 状态码 状态码 描述 201 OK 400 Bad Request 403 Unauthorized 404
添加协议类型为“短信”的订阅 添加协议类型为“邮件”的订阅 在主题列表中，单击“Mytopic”主题右侧的“添加订阅”。 配置订阅参数。 本示例仅解释必要参数，其余大多数配置可保留默认值。关于配置参数的详细说明，请参见添加订阅。 图2 添加订阅配置参数 表2 添加订阅参数设置说明 参数 示例 说明
添加协议类型为“短信”的订阅 添加协议类型为“邮件”的订阅 在主题列表中，单击“Mytopic”主题右侧的“添加订阅”。 配置订阅参数。 本示例仅解释必要参数，其余大多数配置可保留默认值。关于配置参数的详细说明，请参见添加订阅。 图2 添加订阅配置参数 表2 添加订阅参数设置说明 参数 示例 说明
的订阅时，终端节点会多次收到确认订阅信息，且需要在每一条订阅消息内确认订阅。为防止这种场景下对终端节点的消息干扰，建议使用订阅用户功能，一次创建用户后即可导入其他区域的订阅。 订阅用户是提供跨区域统一管理订阅者信息的功能。订阅者可以先创建多个订阅用户，当主题需要添加订阅时，再将订阅用户批量添加到该主题上。
通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region
体的保护规则请参见订阅确认流控说明。 消息通知服务不会校验订阅终端是否真实存在。 添加订阅或请求订阅后，消息通知服务会向订阅终端发送订阅确认信息，信息中包含订阅确认的链接。订阅确认的链接在48小时内有效，用户需要及时在手机端、邮箱或其他协议终端确认订阅。 发送请求订阅消息也会作为发送条数进行计费。
deleteTopicAttributeByName 添加订阅 subscription subscribe 删除订阅 subscription delsubscribe 更新订阅备注 subscription updateSubscriberRemark 添加订阅用户 subscription
API的调用方法请参见如何调用API。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。 涉及API 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 IAM获取token的API
涉及接口 获取用户Token：通过用户名/密码的方式进行认证来获取IAM用户Token。 创建主题：创建Topic。 订阅：为指定Topic添加订阅者。 消息发布：将消息发送给Topic的所有订阅终端。 调试 您可以在API Explorer中调试该接口。 操作步骤 Token认证，具体操作请参考认证鉴权。
涉及接口 获取用户Token：通过用户名/密码的方式进行认证来获取IAM用户Token。 创建主题：创建Topic。 订阅：为指定Topic添加订阅者。 创建消息模板：创建一个模板，用户可以按照模板去发送消息，这样可以减少请求的数据量。 消息发布：将消息发送给Topic的所有订阅终端。
} } } } 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。
当resource_type为“smn_topic”时， 手动添加请求消息头“X-SMN-RESOURCEID-TYPE=name”，资源ID即为topic名称。 不添加请求消息头，通过“查询资源实例”，获取资源ID。 当resource_type为“smn_sms”时，resource_id为签名ID。您可在控制台获取。
个订阅用户，当主题需要添加订阅时，再将订阅用户批量添加到该主题上。 当前订阅用户数据仅支持存储在国内，且仅支持国内站点查询订阅用户数据。 发布区域：华南-广州-友好用户环境 创建订阅用户 请求订阅 修改分组 消息模板管理 消息模板指消息的固定格式，发布消息时可以使用已创建的消息模
果取消成功，页面会显示取消订阅成功，稍后消息通知服务会向这个订阅者发送一封确认取消订阅的邮件(48小时内有效)。如果误操作了取消订阅，可以通过该消息重新订阅。 具体流程如下： 添加订阅后，消息通知服务会向指定邮箱地址发送电子邮件消息，如图5所示，邮件中包含订阅确认的链接。 图5 订阅确认邮件
SMN自定义策略 如果系统预置的SMN权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参考《消息通知服务接口参考》中“ 策略及授权项说明”章节。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按
阅者发送消息时，因运营商限制可能会发送失败。 发布json消息内容 256KB 无 发布模板消息内容 256KB 无 针对订阅的限制项和限制值请参见表2。 表2 订阅的限制项及限制值 限制项 限制值 说明 订阅终端数 10000个 无 订阅确认链接失效时间 48小时 订阅确认的链
当resource_type为“smn_topic”时， 手动添加请求消息头“X-SMN-RESOURCEID-TYPE=name”，资源ID即为topic名称。 不添加请求消息头，通过“查询资源实例”，获取资源ID。 当resource_type为“smn_sms”时，resource_id为签名ID。您可在控制台获取。
责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的云安全挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。
息，具体的保护规则请参见订阅确认流控说明。 消息通知服务不会校验订阅终端是否真实存在。 添加订阅后，消息通知服务会向订阅终端发送订阅确认信息，信息中包含订阅确认的链接。订阅确认的链接在48小时内有效，用户需要及时在手机端、邮箱或其他协议终端确认订阅。 父主题： 订阅用户管理
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
