检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 通过使用消息通知服务所提供的接口,您可以完整的使用消息通知服务的所有功能。例如创建Topic、添加订阅。 表1 接口说明 类型 说明 主题操作 包含创建主题、更新主题、删除主题等接口。 订阅操作 包含查询订阅列表、订阅、取消订阅等接口。 模板操作 包含创建消息模板、更新消息模板、删除消息模板等接口。
本文介绍了SMN服务提供的SDK语言版本,列举了最新版本SDK的获取地址。 在线生成SDK代码 API Explorer能根据需要动态生成SDK代码功能,降低您使用SDK的难度,推荐使用。 SDK列表 在开始使用之前,请确保您安装的是最新版本的SDK。使用过时的版本可能会导致兼容性问
不同协议消息说明 不同的订阅协议接收到的消息包含的内容可能有所不同。 邮件和HTTP(S)终端收到的消息包含:消息主题、消息内容和取消订阅的链接。 短信终端接收到的消息只包含消息内容。 FunctionGraph(函数)终端收到的消息包含消息属性、消息标题、消息内容、主题URN等
创建Topic,单用户默认配额为3000。高并发场景下,可能会出现Topic数量超过3000仍创建成功的情况,此为正常现象。 接口是幂等的,接口调用返回成功时,若已存在同名的Topic,返回的status code为200,否则返回的status code为201 调用方法 请参见如何调用API。 URI POST
com/,单击“注册”。 根据提示信息完成注册,详细操作请参见如何注册华为云管理控制台的用户?。 注册成功后,系统会自动跳转至您的个人信息界面。 参考实名认证完成个人或企业账号实名认证。 为账户充值 您需要确保账户有足够金额。 关于消息通知服务的价格,请参见价格详情。 关于充值,请参见如何给华为云账户充值。
SMN邮件系统预置了部分黑名单邮箱(蜜罐邮箱)名称,如果用户创建类似格式的邮件订阅,为了保护SMN的邮件发送系统,SMN不会将邮件发送到这些地址。请勿使用邮箱地址中含有support、master、admin、service等带有管理员名称的邮箱。 说明:蜜罐邮件指一些被故意放出来的邮箱账号,这些账号一般只能被扫描器
同时设置,生效的优先级为message_structure > message_template_name > message。 tags 否 Map<String,String> tag以及替换tag的参数组成的字典。消息模板中的标签对应的值。使用消息模板方式的消息发布必须携带
为指定Topic添加一个订阅者,如果订阅者的状态为未确认,则向订阅者发送一个确认的消息。待订阅者进行ConfirmSubscription确认后,该订阅者才能收到Topic发布的消息。单Topic默认可添加10000个订阅者,高并发场景下,可能会出现订阅者数量超过10000仍添加成功的情况,此为正常现象
request_id String 请求的唯一标识ID。 error_code String 返回信息对应的代码。 error_msg String 服务异常错误信息描述。 状态码:403 表7 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 error_code
} else { fmt.Println(err) } } 更多编程语言的SDK代码示例,请参见API Explorer的代码示例页签,可生成自动对应的SDK代码示例。 状态码 状态码 描述 200 获取http探测正确返回体 400 Bad Request
API的调用方法请参见如何调用API。 涉及接口 获取用户Token:通过用户名/密码的方式进行认证来获取IAM用户Token。 创建主题:创建Topic。 订阅:为指定Topic添加订阅者。 创建消息模板:创建一个模板,用户可以按照模板去发送消息,这样可以减少请求的数据量。
request_id String 请求的唯一标识ID。 error_code String 返回信息对应的代码。 error_msg String 服务异常错误信息描述。 状态码:500 表7 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 error_code
本章节指导用户通过API发布消息。API的调用方法请参见如何调用API。 涉及接口 获取用户Token:通过用户名/密码的方式进行认证来获取IAM用户Token。 创建主题:创建Topic。 订阅:为指定Topic添加订阅者。 消息发布:将消息发送给Topic的所有订阅终端。 调试 您可以在API
通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 display_name 是 String Topic的显示名,推送邮件消息时,作为邮件发件人显示。显示名的长度为192byte或64个中文。 响应参数 状态码:200
request_id String 请求的唯一标识ID。 message_template_id String 模板唯一的资源标识。 状态码:400 表5 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。
URN是主题的唯一资源标识,不可修改。新创建的主题将显示在主题列表中。 步骤二:添加订阅 分别为主题“Mytopic”添加协议类型为“短信”和“邮件”的订阅。 添加协议类型为“短信”的订阅 添加协议类型为“邮件”的订阅 在主题列表中,单击“Mytopic”主题右侧的“添加订阅”。
oken并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 IAM获取token的API SMN创建Topic的API SMN添加订阅的API SMN发送消息的API 具体步骤 Token认证,具体操作请参考认证鉴权。 创建Topic。发送“POST http
队列,1表示直接丢弃发送失败的消息。 create_time String 创建时间。时间格式为UTC时间,YYYY-MM-DDTHH:MM:SSZ。 name String 创建Topic的名字。 topic_urn String Topic的唯一的资源标识。可以通过查看主题列表获取该标识。
ect-Token的值)。 响应参数 状态码:200 表3 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID 状态码:403 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 error_code
通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 subscription_urns 是 Array of strings 订阅者的唯一的资源标识,可通过查询订阅者列表获取该标识。 响应参数 状态码:200