查询SMN主题 - ListNotificationTopics
功能介绍
查询用户的SMN主题信息。通过该接口可查询用户的SMN主题配置信息，获取到主题名称、ID和数量等关键信息。能够快速获取用户的SMN主题信息，掌握消息推送的渠道和状态。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
lts:alarmNoticeTemplate:list
List
-
-
lts:sqlalarmrules:get
smn:topic:list
URI
GET /v2/{project_id}/lts/notifications/topics
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释： 项目ID，可以从调用API处获取，也可以从控制台获取。获取方式请参见：获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释： 从IAM服务获取的用户Token，获取方式请参见：获取用户Token。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
Content-Type | 是 | String | 参数解释： 用于定义消息体的格式，该字段填为：application/json;charset=utf8。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
request_id | String | 参数解释： 本次请求的唯一标识。 取值范围： 不涉及。 |
topic_count | Integer | 参数解释： SMN主题信息总数。 取值范围： 不涉及。 |
topics | Array of Topics objects | 参数解释： SMN主题信息。 |
请求示例
查询SMN主题。
GET https://{endpoint}/v2/{project_id}/lts/notifications/topics
/v2/{project_id}/lts/notifications/topics?offset={offset}&limit={limit} 响应示例
状态码：200
请求响应成功。
{
"request_id" : "1",
"topic_count" : 100,
"topics" : [ {
"name" : "huawei",
"topic_urn" : "urn:smn:cn-north-7:{projectId}:fyy",
"display_name" : "",
"push_policy" : 0
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | 请求响应成功。 |
错误码
请参见错误码。
