文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 集群管理/ 查询k8s集群事件列表 - ListClusterEventLogs
更新时间:2025-10-31 GMT+08:00
分享

查询k8s集群事件列表 - ListClusterEventLogs

功能介绍

查询k8s集群事件列表

授权信息

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

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

URI

GET /v5/{project_id}/container/kubernetes/cluster/events

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户项目ID

表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

主机所属的企业项目ID。

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

企业项目ID默认取值为“0”,表示默认企业项目。如果需要查询所有企业项目下的主机,请传参“all_granted_eps”。如果您只有某个企业项目的权限,则需要传递该企业项目ID,查询该企业项目下的主机,否则会因权限不足而报错。

cluster_id

String

集群id

cluster_name

String

集群名称

namespace

String

产生事件的命名空间

event_name

String

事件名称

event_type

String

事件类型,包含以下几种:

  • Warning:警告事件

  • Normal:普通事件

resource_type

String

产生事件的资源类型

resource_name

String

产生事件的资源名称

reason

String

事件的触发原因

start_time

Long

查询日志范围的最小时间

end_time

Long

查询日志范围的最大时间

limit

Integer

每页显示个数,默认为10

offset

Integer

偏移量:指定返回记录的开始位置,必须为数字,取值范围为大于或等于0,默认0

line_num

String

查询cce集群事件时需要传的分页行号

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total_num

Integer

日志总条数

data_list

Array of ClusterEventLogResponseInfo objects

k8s集群事件日志列表

表5 ClusterEventLogResponseInfo

参数

参数类型

描述

cluster_name

String

集群名称

cluster_id

String

集群id

cluster_type

String

集群类型,包含以下几种:

  • cce:cce集群

  • ali:阿里云集群

  • tencent:腾讯云集群

  • azure:微软云集群

  • aws:亚马逊集群

  • self_built_hw:华为云自建集群

  • self_built_idc:IDC自建集群

time

Long

日志产生的时间

namespace

String

触发事件的命名空间

event_name

String

事件名称

event_type

String

事件类型

resource_type

String

资源类型

resource_name

String

资源名称

reason

String

事件触发的原因

line_num

String

cce集群事件的行号

请求示例

响应示例

状态码:200

请求已成功

{
  "total_num" : 1,
  "data_list" : [ {
    "cluster_name" : "ywk-55555",
    "cluster_id" : "b075094b-d21a-499a-9006-624089c94402",
    "cluster_type" : "cce",
    "time" : 1814080859608,
    "namespace" : "kube-flannel",
    "event_name" : "kube-flannel-ds-5qrl6.182493b545b889d7",
    "event_type" : "Normal",
    "resource_type" : "imagetag",
    "resource_name" : "kube-flannel-ds-5qrl6",
    "reason" : "Pulling image \"ghcr.io/flannel-io/flannel-cni-plugin:v1.6.2-flannel1\"",
    "line_num" : 12345
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档