检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 通过使用消息通知服务所提供的接口，您可以完整的使用消息通知服务的所有功能。例如创建Topic、添加订阅。 表1 接口说明 类型 说明 主题操作 包含创建主题、更新主题、删除主题等接口。 订阅操作 包含查询订阅列表、订阅、取消订阅等接口。
模板操作 查询消息模板列表 创建消息模板 查询消息模板详情 更新消息模板 删除消息模板 父主题： API
通知策略 创建通知策略 查询通知策略 修改通知策略 删除通知策略 父主题： API
通用请求返回值 异常响应 状态码 父主题： 附录
主题操作 权限 对应API接口 授权项 IAM项目 企业项目 创建主题 POST /v2/{project_id}/notifications/topics smn:topic:create √ √ 查询主题 GET /v2/{project_id}/notifications/topics
标签操作 权限 对应API接口 授权项 IAM项目 企业项目 添加资源标签 POST /v2/{project_id}/{resource_type}/{resource_id}/tags smn:tag:create √ √ 更新标签 - smn:tag:update √ √ 删除资源标签
Application endpoint操作 查询Application的Endpoint列表（废弃） 创建Application endpoint（废弃） 查询Application的Endpoint属性（废弃） 更新Application endpoint（废弃） 删除Application
服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。
图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。 如何选择区域？
SMN:Publish Publish 将消息发送给Topic的所有订阅端点。当返回消息ID时，该消息已被保存并开始尝试将其推送给主题的订阅者。消息格式，取决于该主题每一个订阅者的通知协议。 父主题： 附录
如果订阅者是手机号码，短信长度限制为490字，超出则可能被运营商拦截。短信内容不能包含“[]”或者“【】”符号。
可以向主题发布多少条消息？ 向主题发布消息没有限量。
" } 已完成3.c的确认订阅操作的订阅终端都能接收到该消息，否则无法接收消息。
通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 content 是 String 模板内容。
通过HTTP消息中的signing_cert_url获取证书内容的地址，通过该地址获取证书内容，并且生成X509证书。 下载证书的链接始终是HTTPS请求，需要验证下载链接服务器的证书的真伪。 从X509证书中提取公钥，用于验证收到消息的可靠性和完整性。 确定消息类型。
resource_type 是 String 资源类型，目前有: smn_topic，主题 smn_sms，短信 smn_application，移动推送 resource_id 是 String 资源ID。
例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。
是否会保证将消息传送到订阅的终端节点？ SMN向终端节点推送消息时，使用异步方式送达，不保证消息送达的时效性。如果业务要求消息准实时送达，请慎重考虑是否使用SMN服务。 如果订阅终端节点可以送达，消息通知服务会确保消息传送到订阅终端节点。
快速入门 操作场景 本节通过调用一系列SMN的API实现通过主题发布消息。 API的调用方法请参见如何调用API。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
