j9九游会登录/ 统一身份认证服务 iam_统一身份认证服务（新版）/ api参考/ / / / 获取消息通知配置列表 - listnotificationsettings
更新时间：2025-12-25 gmt 08:00
查看pdf

获取消息通知配置列表 -j9九游会登录

功能介绍

获取消息通知配置列表。

授权信息

账号根用户具备所有api的调用权限，如果使用账号下的iam用户调用当前api，该iam用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

accessanalyzer:notificationsetting:list

read

notificationsetting *

-

-

-

uri

get /v5/notification-settings

表1 query参数

参数

是否必选

参数类型

描述

limit

否

integer

单页最大结果数。

最小值：1

最大值：200

缺省值：100

marker

否

string

页面标记。

最小长度：4

最大长度：400

请求参数

无

响应参数

状态码：200

表2 响应body参数

参数

参数类型

描述

notification_settings

array of notificationsettingsummary objects

消息通知配置列表。

page_info

pageinfo object

页面的信息。
表3 notificationsettingsummary

参数

参数类型

描述

id

string

消息通知配置的唯一标识符。

urn

string

消息通知配置的唯一资源标识符。

analyzer_id

string

分析器的唯一标识符。

analyzer_name

string

分析器的名称。

analyzer_type

string

分析器的类型。

  • account: 账号级外部访问分析器

  • organization：组织级外部访问分析器

  • account_unused_access：账号级未使用访问分析器

  • organization_unused_access：组织级未使用访问分析器

  • account_privilege_escalation：账号级提权访问分析器

  • account_iam_best_practice：账号级iam最佳实践分析器

mc_switch

boolean

是否开启消息中心通知开关。

smn_topic_urns

array of strings

消息通知配置的smn主题urn列表。

created_at

string

创建消息通知配置的时间。

updated_at

string

上次更新消息通知配置的时间。
表4 pageinfo

参数

参数类型

描述

current_count

integer

当前页中的项数。

next_marker

string

如果存在更多可用的输出，那么该值表示可用输出比当前响应中包含的更多。在后续调用此操作时，您可以在标记请求参数中使用此值，以获取输出的下一部分。您应该重复这个过程，直到next_marker返回为null。

状态码：400

表5 响应body参数

参数

参数类型

描述

error_code

string

错误码。

error_msg

string

错误信息。

request_id

string

请求 id。

encoded_authorization_message

string

鉴权信息。

状态码：403

表6 响应body参数

参数

参数类型

描述

error_code

string

错误码。

error_msg

string

错误信息。

request_id

string

请求 id。

encoded_authorization_message

string

鉴权信息。

请求示例

获取消息通知配置列表。

get https://{hostname}/v5/notification-settings

响应示例

状态码：200

ok

{
  "notification_settings" : [ {
    "id" : "{notification_setting_id}",
    "urn" : "accessanalyzer:{region_id}:{domain_id}:notificationsetting:{notification_setting_id}",
    "analyzer_id" : "3de500b3f6c74b0a8ef170656f8a6376",
    "analyzer_type" : "account",
    "analyzer_name" : "external_analyzer_1",
    "mc_switch" : true,
    "smn_topic_urns" : [ "urn:smn:cn-north-7:******:test1" ],
    "created_at" : "2023-09-07t08:04:41.698z",
    "updated_at" : "2023-09-07t08:04:41.698z"
  }, {
    "id" : "{notification_setting_id}",
    "urn" : "accessanalyzer:{region_id}:{domain_id}:notificationsetting:{notification_setting_id}",
    "analyzer_id" : "7d866d909fda4e32b1fc2aae45c34a97",
    "analyzer_type" : "account",
    "analyzer_name" : "external_analyzer_2",
    "mc_switch" : true,
    "smn_topic_urns" : [ "urn:smn:cn-north-7:******:test1" ],
    "created_at" : "2023-09-07t08:04:41.698z",
    "updated_at" : "2023-09-07t08:04:41.698z"
  } ],
  "page_info" : {
    "current_count" : 2,
    "next_marker" : null
  }
}

状态码

状态码

描述

200

ok

400

bad request

403

forbidden

错误码

请参见错误码。

父主题：

相关文档

网站地图