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

查询容器日志列表 - ListContainerLogs

功能介绍

查询容器日志列表

授权信息

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

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

URI

GET /v5/{project_id}/container/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

集群名称

namespace

String

产生日志的容器所属的命名空间

pod_name

String

产生日志的容器所属pod的名称

pod_id

String

产生日志的容器所属pod的id

pod_ip

String

产生日志的容器所属pod的ip

host_ip

String

产生日志的容器所在主机的ip

container_id

String

容器id

container_name

String

产生日志的容器名称

content

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

k8s集群容器日志列表

表5 ClusterContainerLogResponseInfo

参数

参数类型

描述

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

容器日志所属的命名空间

pod_name

String

产生日志的容器所属pod的名称

pod_id

String

产生日志的容器所属pod的id

pod_ip

String

产生日志的容器所属pod的ip

host_ip

String

产生日志的容器所在的主机ip

container_name

String

产生日志的容器名称

container_id

String

产生日志的容器id

content

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" : "hss",
    "pod_name" : "infer-39cce5d3-07b2-4794-a69d-fc758d507ce1-gruhs-role-0-5d5hzbq",
    "pod_id" : "b075094b-d21a-499a-9006-624089c94402",
    "pod_ip" : "192.168.0.93",
    "host_ip" : "192.168.0.9",
    "container_name" : "k8s_infer-3bb780ef-01b2-45b3-bf0c-fc758d507ce1_infer-39cce5d3-07b2-4794-a69d-fc758d507ce1-gruhs-role-0-5d5hzbq_pool-x-infer-test-04f258c84780d5a52f3bc00dc15aa5e7_1dbafeed-e3bb-4bc6-9eaa-1f9bdb50df26_1",
    "container_id" : "16***0dc-94cb-4ca3-9087-06***cd168c1",
    "content" : "successfully started container k8s_infer-3bb780ef-01b2-45b3-bf0c-fc758d507ce1_infer-39cce5d3-07b2-4794-a69d-fc758d507ce1-gruhs-role-0-5d5hzbq_pool-x-infer-test-04f258c84780d5a52f3bc00dc15aa5e7_1dbafeed-e3bb-4bc6-9eaa-1f9bdb50df26_1",
    "line_num" : 123123
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档