更新时间:2025-09-25 GMT+08:00
分享

获取消息通知配置列表

功能介绍

获取消息通知配置列表。

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_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

错误码

请参见错误码

相关文档