更新时间:2026-07-03 GMT+08:00

查询Pod事件 - ListV2DeploymentPodEvents

功能介绍

本接口用于查询指定Pod的Kubernetes事件,适用于需要监控和排查Pod运行状态的场景。调用此接口前,确保已具备相应的查询权限,并提供有效的Pod ID。返回的事件列表将包含每个事件的详细信息,如事件类型、发生次数、事件名称、事件信息、发生时间等。如果提供的Pod ID无效、Pod不存在或权限不足,将返回相应的异常信息,提示用户检查输入数据的有效性和权限。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

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

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    modelarts:service:listDeploymentPodEvents

    Read

    service *

    -

    -

    -

URI

GET /v2/{project_id}/services/{id}/deployments/{deployment_name}/instances/{instance_name}/pods/{name}/events

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

用户项目ID。获取方法请参见获取项目ID和名称

约束限制:

不涉及。

取值范围:

账号的项目ID。

默认取值:

不涉及。

id

String

参数解释:

服务ID,在创建服务时即可在返回体中获取,也可通过查询服务列表获取当前用户拥有的服务,其中service_id字段即为服务ID。

约束限制:

不涉及。

取值范围:

服务ID。

默认取值:

不涉及。

deployment_name

String

参数解释:

部署名称,在创建部署时即可在返回体中获取,也可通过查询服务部署列表获取当前用户拥有的部署,其name字段即为部署名称。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

instance_name

String

参数解释:

服务实例名字,可以为all,为all时去查询所有的服务实例。

约束限制:

不涉及。

取值范围:

服务实例名字。

默认取值:

不涉及。

name

String

参数解释:

服务实例pod名字,可以为all,为all时去查询所有的服务实例。

约束限制:

不涉及。

取值范围:

服务实例名字。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

[数组元素]

Array of ServicePodEventResponse objects

参数解释:

服务Pod事件列表。

表4 ServicePodEventResponse

参数

参数类型

描述

count

Integer

参数解释:

事件发生次数。

取值范围:

不涉及。

first_timestamp

String

参数解释:

首次发生时间。

取值范围:

不涉及。

last_timestamp

String

参数解释:

最近发生时间。

取值范围:

不涉及。

message

String

参数解释:

事件信息。

取值范围:

不涉及。

reason

String

参数解释:

事件名称。

取值范围:

不涉及。

reporting_component

String

参数解释:

上报该事件的k8s组件名。

取值范围:

不涉及。

type

String

参数解释:

事件类型。

取值范围:

Normal/Warning。

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

ModelArts错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

具体错误信息。

取值范围:

不涉及。

状态码:401

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

ModelArts错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

具体错误信息。

取值范围:

不涉及。

状态码:403

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

ModelArts错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

具体错误信息。

取值范围:

不涉及。

状态码:404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

ModelArts错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

具体错误信息。

取值范围:

不涉及。

请求示例

查询指定Pod事件。

GET https://{endpoint}/v2/{project_id}/services/{service_id}/deployments/{deployment_id}/instances/{name}/pods/{pod_name}/events

响应示例

状态码:200

Pod事件列表。

[ {
  "count" : 5,
  "first_timestamp" : "2025-05-24T08:11:24Z",
  "last_timestamp" : "2025-05-24T08:11:53Z",
  "message" : "Back-off restarting failed container infer-5efd9b09-1f85-49f7-8735-9ec539ebac93 in pod infer-689e24bb-4489-499b-becb-9ec539ebac93-cfvs4-role-0-68cj4gd_pool-x-infer-04f258c84780d5a52f3bc00dc15aa5e7(bc6663ae-657c-4a4b-bb3e-35011483e4e9)",
  "reason" : "BackOffStart",
  "reporting_component" : "kubelet",
  "type" : "Warning"
}, {
  "count" : 5,
  "first_timestamp" : "2025-05-24T08:11:24Z",
  "last_timestamp" : "2025-05-24T08:11:53Z",
  "message" : "the failed container exited with ExitCode: 1",
  "reason" : "BackOffStart",
  "reporting_component" : "kubelet",
  "type" : "Warning"
}, {
  "count" : 3,
  "first_timestamp" : "2025-05-24T08:11:23Z",
  "last_timestamp" : "2025-05-24T08:11:38Z",
  "message" : "Started container infer-5efd9b09-1f85-49f7-8735-9ec539ebac93",
  "reason" : "Started",
  "reporting_component" : "kubelet",
  "type" : "Normal"
} ]

状态码

状态码

描述

200

Pod事件列表。

400

请求参数不合法。

401

鉴权非法。

403

权限不足。

404

资源未找到。

错误码

请参见错误码