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