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

查询k8s集群审计日志列表 - ListClusterAuditLogs

功能介绍

查询k8s集群审计日志列表

授权信息

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

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

URI

GET /v5/{project_id}/container/kubernetes/cluster/audit-logs

表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

集群名称

host_name

String

主机名称

host_id

String

主机id

host_ip

String

主机ip

verb

String

审计日志对应的动作,包含以下几种:

  • create:创建资源

  • delete:删除资源

  • deletecollection:批量删除资源集合

  • patch:修改资源

  • update:更新资源

  • get:获取资源

  • list:获取资源列表

  • watch:监控资源

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 ClusterAuditLogResponseInfo objects

k8s集群审计日志列表

表5 ClusterAuditLogResponseInfo

参数

参数类型

描述

cluster_name

String

集群名称

cluster_id

String

集群id

time

Long

日志产生的时间

content

String

审计日志的内容,json格式的字符串

cluster_type

String

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

  • cce:cce集群

  • ali:阿里云集群

  • tencent:腾讯云集群

  • azure:微软云集群

  • aws:亚马逊集群

  • self_built_hw:华为云自建集群

  • self_built_idc:IDC自建集群

host_id

String

主机ID

host_name

String

主机名称

host_ip

String

主机ip

line_num

String

cce集群日志的行号

请求示例

响应示例

状态码:200

请求已成功

{
  "total_num" : 1,
  "data_list" : [ {
    "cluster_name" : "ywk-55555",
    "cluster_id" : "b075094b-d21a-499a-9006-624089c94402",
    "time" : 1814080859608,
    "content" : "listImageTagscdcssd-2/log4j:*, Method:GET Url=/v2/manage/namespaces/cdcssd-2/repos/log4j/tags, Reason",
    "cluster_type" : "cce",
    "host_id" : "16***0dc-94cb-4ca3-9087-06***cd168c1",
    "host_name" : 111,
    "host_ip" : "192.168.0.93"
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档