文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 集群防护/ 修改告警状态 - ChangeClusterEvents
更新时间:2025-10-31 GMT+08:00
分享

修改告警状态 - ChangeClusterEvents

功能介绍

修改告警状态

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

PUT /v5/{project_id}/cluster-protect/events

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产。获取方式请参见获取项目ID

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

参数解释:

企业项目ID,用于过滤不同企业项目下的资产。获取方式请参见获取企业项目ID

如需查询所有企业项目下的资产请传参“all_granted_eps”。

约束限制:

开通企业项目功能后才需要配置企业项目ID参数。

取值范围:

字符长度1-256位

默认取值:

0,表示默认企业项目(default)。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token,包含了用户的身份、权限等信息,在调用API接口时,可通过Token进行身份认证。获取方式请参见获取用户Token

约束限制:

不涉及

取值范围:

字符长度1-32768位

默认取值:

不涉及

表4 请求Body参数

参数

是否必选

参数类型

描述

total_num

Integer

总数

opr

String

操作类型,包含以下几种:

  • ignore:忽略

  • handle:处理

  • addWhiteImage:加白

data_list

Array of strings

事件ID列表

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

total_num

Integer

总数

last_update_time

Long

最近更新时间

data_list

Array of ClusterEventResponseInfo objects

集群安全事件列表

表6 ClusterEventResponseInfo

参数

参数类型

描述

action

String

阻断动作

cluster_name

String

集群名称

cluster_id

String

集群Id

event_name

String

事件名称

event_class_id

String

事件唯一标识

event_id

String

事件id

event_type

Integer

事件类型

event_content

String

事件内容

handle_status

String

处理状态,包含如下:

  • unhandled:未处理

  • handled:已处理

create_time

Long

创建时间

update_time

Long

更新时间

project_id

String

项目ID

enterprise_project_id

String

企业ID

policy_name

String

策略名称

policy_id

String

策略ID

resource_info

ClusterEventResourceResponseInfo object

事件资源信息

表7 ClusterEventResourceResponseInfo

参数

参数类型

描述

enforcement_action

String

执行动作

group

String

Group

message

String

信息

name

String

名称

namespace

String

命名空间

version

String

版本

kind

String

资源类型

resource_name

String

资源名称

请求示例

修改告警状态

PUT https://{endpoint}/v5/{project_id}/cluster-protect/events?enterprise_project_id=all_granted_eps

{
  "total_num" : 1,
  "opr" : "ignore",
  "data_list" : [ "daa271e0-9bdb-49cd-9f74-6f1a74686bd1" ]
}

响应示例

状态码:200

请求已成功

{
  "total_num" : 1,
  "last_update_time" : 1695094500324,
  "data_list" : [ {
    "action" : "84b5266c14ae489fa6549827f032dc62",
    "cluster_name" : "cce-01",
    "cluster_id" : "44753d6c-415e-11ee-834b-0255ac1001b2",
    "event_name" : "ExpressionInject",
    "event_class_id" : "clusterprotect_1001",
    "event_id" : "03368dc5-80ae-482f-8fa8-e62d778bb29f",
    "event_type" : 3009,
    "event_content" : "{\"enforcementAction\":\"warn\",\"group\":\"\",\"kind\":\"Pod\",\"message\":\"hit label a4, vul image nginx can not startup.\",\"name\":\"deny11\",\"namespace\":\"test-lby\",\"version\":\"v1\"}",
    "handle_status" : "unhandled",
    "create_time" : 1695094500324,
    "update_time" : 1695094500324,
    "project_id" : "84b5266c14ae489fa6549827f032dc62",
    "enterprise_project_id" : "0",
    "policy_name" : "test-warn",
    "policy_id" : "4636a2d6-1b8c-44d3-863d-7d881348d32a",
    "resource_info" : {
      "enforcement_action" : "warn",
      "group" : "",
      "message" : "hit label a4, vul image swr.cn-north-7.myhuaweicloud.com/scc_cgs_f00418753/nginx:test can not startup.",
      "name" : "nginx-test-65d79f9d9f-jmmn4",
      "namespace" : "default",
      "version" : "v1",
      "kind" : "Pod",
      "resource_name" : "WINDOWS-COMPILE"
    }
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档