本文导读

功能介绍
调用方法
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 集群防护/ 获取所有集群中告警事件

获取所有集群中告警事件

更新时间：2025-06-13 GMT+08:00

在线调试

CLI示例

查看PDF

功能介绍

获取所有集群中告警事件

调用方法

请参见如何调用API。

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目ID，可通过我的凭证，项目id获取约束限制: 不涉及取值范围: 字符长度1-256位默认取值: 不涉及

表2 Query参数
参数	是否必选	参数类型	描述
enterprise_project_id	否	String	参数解释: 主机所属的企业项目ID。企业项目ID默认取值为“0”，表示默认企业项目。如果需要查询所有企业项目下的主机，请传参“all_granted_eps”。如果您只有某个企业项目的权限，则需要传递该企业项目ID，查询该企业项目下的主机，否则会因权限不足而报错。约束限制: 开通企业项目功能后才需要配置企业项目。取值范围: 字符长度1-256位默认取值: 0
offset	是	Integer	偏移量：指定返回记录的开始位置
limit	是	Integer	每页显示个数
cluster_id	否	String	集群ID

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
total_num	Integer	总数
last_update_time	Long	最近更新时间
data_list	Array of ClusterEventResponseInfo objects	集群安全事件列表

表5 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	事件资源信息

表6 ClusterEventResourceResponseInfo
参数	参数类型	描述
enforcement_action	String	执行动作
group	String	Group
message	String	信息
name	String	名称
namespace	String	命名空间
version	String	版本
kind	String	资源类型
resource_name	String	资源名称

请求示例

获取所有集群中告警事件

GET https://{endpoint}/v5/{project_id}/cluster-protect/events?offset=0&limit=200&enterprise_project_id=all_granted_eps

响应示例

状态码：200

请求已成功

{
  "total_num" : 2,
  "data_list" : [ {
    "projectId" : "84b5266c14ae489fa6549827f032dc62",
    "enterpriseProjectId" : "0",
    "action" : "warn",
    "updateTime" : 1695094500324,
    "event_id" : "03368dc5-80ae-482f-8fa8-e62d778bb29f",
    "cluster_id" : "44753d6c-415e-11ee-834b-0255ac1001b2",
    "event_class_id" : "clusterprotect_1001",
    "event_type" : 3009,
    "handle_status" : "unhandled",
    "event_content" : "{\"enforcementAction\":\"warn\",\"group\":\"\",\"kind\":\"Pod\",\"message\":\"hit label a4, vul image nginx can not startup.\",\"name\":\"deny11\",\"namespace\":\"test-lby\",\"version\":\"v1\"}",
    "policy_id" : "4636a2d6-1b8c-44d3-863d-7d881348d32a",
    "policy_name" : "lbytest-warn",
    "resource_info" : {
      "enforcementAction" : "warn",
      "group" : "",
      "kind" : "Pod",
      "message" : "hit label a4, vul image nginx can not startup.",
      "name" : "deny11",
      "namespace" : "test-lby",
      "version" : "v1"
    }
  }, {
    "projectId" : "84b5266c14ae489fa6549827f032dc62",
    "enterpriseProjectId" : "0",
    "action" : "warn",
    "updateTime" : 1695094500324,
    "event_id" : "cbbf88ab-385f-4ecc-a3b2-b933bdbd467f",
    "cluster_id" : "44753d6c-415e-11ee-834b-0255ac1001b2",
    "event_class_id" : "clusterprotect_1001",
    "event_type" : 3009,
    "handle_status" : "unhandled",
    "event_content" : "{\"enforcementAction\":\"warn\",\"group\":\"\",\"kind\":\"Pod\",\"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\"}",
    "policy_id" : "4636a2d6-1b8c-44d3-863d-7d881348d32a",
    "policy_name" : "lbytest-warn",
    "resource_info" : {
      "enforcementAction" : "warn",
      "group" : "",
      "kind" : "Pod",
      "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"
    }
  } ]
}

状态码


状态码	描述
200	请求已成功

错误码

请参见错误码。

父主题：集群防护

上一篇：获取集群防护默认策略列表

下一篇：修改告警状态

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

获取所有集群中告警事件

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

文档反馈