查询容器内运行的命令列表 - ListContainerCmdLogs
功能介绍
查询容器内运行的命令列表
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v5/{project_id}/container/cmd-histories
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
租户项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
x-auth-token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total_num |
Integer |
日志总条数 |
|
data_list |
Array of ContainerCmdLogResponseInfo objects |
容器内运行命令的日志列表 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
cluster_name |
String |
集群名称 |
|
cluster_id |
String |
集群id |
|
cluster_type |
String |
集群类型,包含以下几种:
|
|
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 |
容器内运行命令列表 |
错误码
请参见错误码。