文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 容器管理/ 查询容器内运行的命令列表 - ListContainerCmdLogs
更新时间:2025-10-31 GMT+08:00
分享

查询容器内运行的命令列表 - ListContainerCmdLogs

功能介绍

查询容器内运行的命令列表

授权信息

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

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

URI

GET /v5/{project_id}/container/cmd-histories

表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

container_id

String

容器id

container_name

String

产生日志的容器名称

cmd

String

运行的命令行

path

String

命令行对应的进程路径

start_time

Long

查询日志范围的最小时间

end_time

Long

查询日志范围的最大时间

limit

Integer

每页显示个数,默认为10

offset

Integer

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

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

x-auth-token

String

用户Token。

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

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total_num

Integer

日志总条数

data_list

Array of ContainerCmdLogResponseInfo objects

容器内运行命令的日志列表

表5 ContainerCmdLogResponseInfo

参数

参数类型

描述

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

日志产生的时间

host_id

String

主机ID

host_name

String

主机名称

private_ip

String

容器所在主机的私网ip

public_ip

String

主机ip

container_name

String

产生日志的容器名称

container_id

String

产生日志的容器id

cmd

String

执行的命令

path

String

命令行对应的进程路径

process_pid

Integer

命令行对应的进程pid

user_name

String

执行命令的用户

group_name

String

执行命令的用户所属用户组

parent_process_pid

Integer

父进程pid

parent_path

String

父进程路径

请求示例

响应示例

状态码:200

容器内运行命令列表

{
  "total_num" : 1,
  "data_list" : [ {
    "cluster_name" : "cluster_1323",
    "cluster_id" : "d8980c20-fd83-418a-a9c1-1abe9044ee3a",
    "cluster_type" : "cce",
    "time" : 1736925153481,
    "host_id" : "09724867-7b91-482d-9702-daf9113f1b62",
    "host_name" : "agentcompile-2",
    "private_ip" : "172.16.0.**",
    "public_ip" : "100.0.0.1",
    "container_name" : "edfry",
    "container_id" : "eedf8817-f486-4c4f-a395-b8373ecc7ef4",
    "cmd" : "nsenter -t 1 -m -n -i -p -u systemctl is-enabled docker",
    "path" : "/usr/bin/ls",
    "process_pid" : 12345,
    "user_name" : "testuser",
    "group_name" : "testuser",
    "parent_process_pid" : 542637,
    "parent_path" : "/usr/bin/containerd-shim"
  } ]
}

状态码

状态码

描述

200

容器内运行命令列表

错误码

请参见错误码

相关文档