检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
称。 创建主题后，主题名称为主题的唯一标识，一旦创建后不能再修改主题名称。SMN将为该主题分配唯一的URN，其中包括服务名称（SMN）、区域名称、项目ID和主题名称。URN将作为创建主题时使用的API调用的一部分返回。无论何时发布者或者订阅者需要对该主题执行任何操作，都应引用该唯一主题URN。
URN是SMN用来标识资源的字符串，目前存在以下几种类型。 主题URN 创建主题后，SMN将为该主题分配的唯一资源标识，其中包括服务名称（SMN）、区域名称、项目ID和主题名称。形如：urn:smn:region:cffe4fc4c9a54219b60dbaf7b586e132:Mytopi
“短信”：消息以短信文本消息发送到订阅的电话号码。 “HTTP”、“HTTPS”： 消息以HTTP/HTTPS请求的形式发送到订阅的URL，目前只支持公网域名或者公网IP地址。 “FunctionGraph（函数）”：使用已发布的消息的负载调用订阅的FunctionGraph（函数）终端。 “F
描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如IAM服务在“华北-北京四”区域的Endpoint为“iam
云服务都使用SMN，从而可使您在事件发生（如云审计服务检测到云服务资源发生关键操作）时能立即接收到通知。 与云服务的集成 将SMN作为消息连接不同的云服务，可降低系统复杂度，提升服务使用效率。例如将消息从云服务（如CES）通知到其他服务（如OBS），实现服务解耦。即便一个服务出现故障，也不会影响到其他服务。
失败的消息队列中的消息处理间隔时间是不确定的，它取决于失败的消息队列的长度。 SMN向HTTP(S)订阅终端发送消息的超时时间为5s，即响应时长超过5s后，SMN会认为连接超时发送失败。 指定时间段内如果多次发送失败，则会加入到黑名单中，加入到黑名单的订阅终端SMN不再向其发送消息。 黑名单中的订阅终端会在5
查询主题列表 功能介绍 分页查询Topic列表，Topic列表按照Topic创建时间进行降序排列。分页查询可以指定offset以及limit。如果不存在Topic，则返回空列表。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/notifications/topics
更新主题 功能介绍 更新显示名。 调用方法 请参见如何调用API。 URI PUT /v2/{project_id}/notifications/topics/{topic_urn} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取项目ID请参考
创建主题 功能介绍 创建Topic，单用户默认配额为3000。高并发场景下，可能会出现Topic数量超过3000仍创建成功的情况，此为正常现象。 接口是幂等的，接口调用返回成功时，若已存在同名的Topic，返回的status code为200，否则返回的status code为201
查询主题详情 功能介绍 查询Topic的详细信息。 调用方法 请参见如何调用API。 URI GET /v2/{project_id}/notifications/topics/{topic_urn} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
授权操作与SMN接口的映射关系 表1 授权操作与SMN接口的映射关系 授权操作 接口名称 接口功能 SMN:UpdateTopic UpdateTopic 修改主题的属性，目前仅支持修改topic的display_name字段。 SMN:DeleteTopic DeleteTopic
快速入门 操作场景 本节通过调用一系列SMN的API实现通过主题发布消息。 API的调用方法请参见如何调用API。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。 涉及API 当您使用Token认证方式完成
示例1：使用主题发布消息 操作场景 本章节指导用户通过API发布消息。API的调用方法请参见如何调用API。 涉及接口 获取用户Token：通过用户名/密码的方式进行认证来获取IAM用户Token。 创建主题：创建Topic。 订阅：为指定Topic添加订阅者。 消息发布：将消息发送给Topic的所有订阅终端。
示例2：使用消息模板方式发布消息 操作场景 本章节指导用户通过API使用消息模板方式发布消息。API的调用方法请参见如何调用API。 涉及接口 获取用户Token：通过用户名/密码的方式进行认证来获取IAM用户Token。 创建主题：创建Topic。 订阅：为指定Topic添加订阅者。
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 200 SMN.0190 This endpoint already exists. endpoint已存在。
查询资源实例 功能介绍 使用标签过滤实例。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/{resource_type}/resource_instances/action 表1 路径参数 参数 是否必选 参数类型 描述 project_id
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
