检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
创建Topic,单用户默认配额为3000。高并发场景下,可能会出现Topic数量超过3000仍创建成功的情况,此为正常现象。 接口是幂等的,接口调用返回成功时,若已存在同名的Topic,返回的status code为200,否则返回的status code为201 调用方法 请参见如何调用API。 URI POST
为指定Topic添加一个订阅者,如果订阅者的状态为未确认,则向订阅者发送一个确认的消息。待订阅者进行ConfirmSubscription确认后,该订阅者才能收到Topic发布的消息。单Topic默认可添加10000个订阅者,高并发场景下,可能会出现订阅者数量超过10000仍添加成功的情况,此为正常现象
项目ID。 获取项目ID请参考 获取项目ID。 topic_urn 是 String Topic的唯一的资源标识,可通过查询主题列表获取该标识。 logtank_id 是 String 云日志信息唯一的资源标识。可通过查询云日志获取该标识。 请求参数 表2 请求Header参数 参数 是否必选
当前key的参数值只能取“resource_name”,此时value的参数值为云服务器名称。 key不能重复,value为匹配的值。 此字段为固定字典值。 不允许为空字符串。 value 是 String 值。 当前key的参数值只能取“resource_name”,此时value的参数值为云服务器名称。 每个值最大长度255个unicode字符。
subscription_urn 是 String 订阅者的唯一的资源标识,可通过查询订阅者列表获取该标识。 filter_polices 是 Array of SubscriptionsFilterPolicy objects 订阅者的过滤策略。策略name不能重复 表5 SubscriptionsFilterPolicy
} else { fmt.Println(err) } } 更多编程语言的SDK代码示例,请参见API Explorer的代码示例页签,可生成自动对应的SDK代码示例。 状态码 状态码 描述 200 发送http探测成功 400 发送http探测失败 403
如您的组织已经设定消息通知的相关标签策略,则需按照标签策略规则为主题添加标签。标签如果不符合标签策略的规则,则可能会导致主题创建失败,请联系组织管理员了解标签策略详情。 键的长度最大128字符,值的长度最大255字符。 标签的键可以包含任意语种的字母、数字和空格,以及_.:=+-@字符,但首
request_id String 请求的唯一标识ID。 error_code String 返回信息对应的代码。 error_msg String 服务异常错误信息描述。 状态码:403 表7 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 error_code
request_id String 请求的唯一标识ID。 message_template_id String 模板唯一的资源标识。 状态码:400 表5 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 code String 服务异常错误信息编码。
request_id String 请求的唯一标识ID。 error_code String 返回信息对应的代码。 error_msg String 服务异常错误信息描述。 状态码:403 表7 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 error_code
属性作用 属性默认值 access_policy Topic资源的访问策略,控制其他用户访问该Topic的权限。 空字符串。 introduction 在邮件和短信订阅确认信息中展示Topic的介绍,使您能够让订阅者对主题有更多的了解。 空字符串。 父主题: 附录
使用AK/SK认证时,您可以基于签名算法使用AK/SK对请求进行签名,也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能,与服务提供的SDK不同,使用时请注意。 Token认证 Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。
Notification,SMN)是可靠的、可扩展的、海量的消息处理服务。它可以依据用户的需求主动推送通知消息,最终用户可以通过短信、电子邮件等方式接收。 图1 SMN产品架构 SMN的主题订阅模型,旨在提供一对多的消息订阅以及通知功能,能够实现一站式集成多种推送通知方式。在SMN中有两种类型的客户端,即发
记录消息通知服务 记录消息通知服务简介 支持审计的关键操作列表 查询审计事件
向主题发布模板消息 操作场景 消息模板指消息的固定格式。如果您要发布的消息内容丰富,并且这条消息需要多次发布,每次发布时需要变更的内容极少,此时您可以套用已创建的消息模板向订阅者发送消息。 在相同的消息模板名称下面,可创建一个或多个不同协议类型的消息模板来适配不同协议的订阅者,但必须包含一个Def
topic_urn String Topic的唯一的资源标识 subscriber_urn String 订阅者的唯一资源标识。 protocol_name String 不同协议对应不同的endpoint(接受消息的接入点)。目前支持的协议包括: “email”:邮件传输协议,endpoint为邮箱地址。
主题操作 查询主题列表 创建主题 查询主题详情 更新主题 删除主题 查询主题策略 删除所有主题策略 更新主题策略 删除指定名称的主题策略 父主题: API
项目ID。获取项目ID请参考 获取项目ID。 topic_urn 是 String Topic的唯一的资源标识,可通过查询主题列表获取该标识。 name 是 String 主题策略名称。只支持特定的策略名称,请参见Topic属性表。 请求参数 表2 请求Header参数 参数 是否必选
与其他服务的关系 其他云服务可以集成SMN,为云服务提供事件通知的能力,使这些服务可以向租户或者消息处理系统发送事件通知。对接SMN的云服务使用SMN的详细信息请参见相应服务的用户指南。 现列举几个云服务使用SMN的例子,如图1所示。 图1 消息通知服务与其他服务的关系示意图 表1
String 键,表示要匹配的字段。 当前key的参数值只能取“resource_name”,此时value的参数值为云服务器名称。 key不能重复,value为匹配的值。 此字段为固定字典值。 不允许为空字符串。 value 是 String 值。 当前key的参数值只能取“reso