文档首页/ 云审计服务 CTS/ API参考（安卡拉区域）/ API/ 关键操作通知管理/ 查询关键操作通知
更新时间：2025-03-21 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询关键操作通知

功能介绍

查询创建的关键操作通知规则。

调用方法

请参见如何调用API。

URI

GET /v3/{project_id}/notifications/{notification_type}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，参见获取账号ID和项目ID章节。

notification_type

是

String

通知类型。

-smn：消息通知服务。

-fun：函数工作流。
表2 Query参数

参数

是否必选

参数类型

描述

notification_name

否

String

标识关键操作通知名称。 在不传入该字段的情况下，将查询当前租户所有的关键操作通知。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

notifications

Array of NotificationsResponseBody objects

关键操作通知列表。
表4 NotificationsResponseBody

参数

参数类型

描述

notification_name

String

标识关键操作名称。

operation_type

String

标识操作类型。

目前支持的操作类型有完整类型(complete)和自定义类型(customized)。

完整类型下，CTS发送通知的对象为已对接服务的所有事件。

自定义类型下，CTS发送通知的对象是在operations列表中指定的事件。

operations

Array of Operations objects

操作事件列表。

notify_user_list

Array of NotificationUsers objects

通知用户列表，目前最多支持对10个用户组和50个用户发起的操作进行配置。

status

String

标识关键操作通知状态，包括正常(enabled)，停止(disabled)两种状态。

topic_id

String

消息通知服务的topic_urn或者函数工作流的func_urn。- 消息通知服务的topic_urn可以通过消息通知服务的查询主题列表API获取，示例：urn:smn:regionId:f96188c7ccaf4ffba0c9aa149ab2bd57:test_topic_v2。- 函数工作流的func_urn可以通过函数工作流的获取函数列表API获取，示例：urn:fss:xxxxxxxxx:7aad83af3e8d42e99ac194e8419e2c9b:function:default:test。

notification_id

String

关键操作通知的唯一标识。

notification_type

String

关键操作通知类型，根据topic_id区分为消息通知服务(smn)和函数工作流(fun)。

project_id

String

项目ID。

create_time

Long

关键操作通知创建时间戳。

filter

Filter object

关键操作通知高级筛选条件。

agency_name

String

云服务委托名称。
表5 Operations

参数

参数类型

描述

service_type

String

标识云服务类型。必须为已对接CTS的云服务的英文缩写，且服务类型一般为大写字母。

已对接的云服务列表参见《云审计服务用户指南》“支持审计的服务及详细操作列表”章节，单击对应云服务的文档链接，可以查看到该云服务的英文缩写。

resource_type

String

标识资源类型。

trace_names

Array of strings

标识事件名称。
表6 NotificationUsers

参数

参数类型

描述

user_group

String

IAM用户组。

user_list

Array of strings

IAM用户。
表7 Filter

参数

参数类型

描述

condition

String

多条件关系。

  • AND(默认值) 表示所有过滤条件满足后生效。

  • OR 表示有任意一个条件满足时生效。

is_support_filter

Boolean

是否打开高级筛选开关。

rule

Array of strings

高级过滤条件规则，示例如下："key != value"，格式为：字段 规则 值。-字段取值范围：api_version,code,trace_rating,trace_type,resource_id,resource_name。-规则：!= 或 =。- 值：api_version正则约束：^(a-zA-Z0-9_-.){1,64}$；code：最小长度1，最大长度256；trace_rating枚举值："normal", "warning", "incident"；trace_type枚举值："ConsoleAction", "ApiCall", "SystemAction"；resource_id：最小长度1，最大长度350；resource_name：最小长度1，最大长度256

状态码：400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码标识，CTS.XXX。

error_msg

String

错误描述。

状态码：401

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码标识，CTS.XXX。

error_msg

String

错误描述。

状态码：403

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码标识，CTS.XXX。

error_msg

String

错误描述。

状态码：404

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码标识，CTS.XXX。

error_msg

String

错误描述。

状态码：500

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码标识，CTS.XXX。

error_msg

String

错误描述。

状态码：503

表13 响应Body参数

参数

参数类型

描述

error_code

String

错误码标识，CTS.XXX。

error_msg

String

错误描述。

请求示例

无

响应示例

状态码：200

查询成功。

{
  "notifications" : [ {
    "create_time" : 1633933167385,
    "notify_user_list" : [ {
      "user_group" : "admin",
      "user_list" : [ "test1", "test2" ]
    }, {
      "user_group" : "CTS view",
      "user_list" : [ "test3", "test4" ]
    } ],
    "notification_id" : "0b98e1c2-2fd6-4e33-a355-f9e12eaab88a",
    "notification_name" : "test2",
    "notification_type" : "smn",
    "operation_type" : "customized",
    "operations" : [ {
      "resource_type" : "tracker",
      "service_type" : "CTS",
      "trace_names" : [ "createTracker" ]
    }, {
      "resource_type" : "notification",
      "service_type" : "CTS",
      "trace_names" : [ "deleteNotification", "updateNotification" ]
    }, {
      "resource_type" : "pe",
      "service_type" : "AOM",
      "trace_names" : [ "createPolicyGroup", "updatePolicyGroup", "deletePolicyGroup" ]
    } ],
    "project_id" : "24edf66e79d04187acb99a463e610764",
    "status" : "enabled",
    "topic_id" : "urn:smn:{regionid}:24edf66e79d04187acb99a463e610764:test"
  }, {
    "create_time" : 1633924057706,
    "notify_user_list" : [ {
      "user_group" : "admin",
      "user_list" : [ "test1", "test2" ]
    }, {
      "user_group" : "CTS view",
      "user_list" : [ "test3", "test4" ]
    } ],
    "notification_id" : "6d4a09bb-aa8e-40db-9e87-0d5e203823a8",
    "notification_name" : "test1",
    "notification_type" : "smn",
    "operation_type" : "complete",
    "operations" : [ ],
    "project_id" : "24edf66e79d04187acb99a463e610764",
    "status" : "disabled"
  } ]
}

状态码

状态码

描述

200

查询成功。

400

服务器未能处理请求。

401

请求鉴权校验失败，访问被拒绝。

403

请求权限校验失败，访问被禁止。

404

服务器无法找到被请求的资源或部分关键操作通知删除失败。

500

服务内部异常，请求未完成；或部分追踪器删除失败。

503

被请求的服务无效。建议直接修改该请求，不要重试该请求。

错误码

请参见错误码。