查询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
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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时去查询所有的服务实例。 约束限制: 不涉及。 取值范围: 服务实例名字。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。通过调用IAM服务获取用户Token接口获取响应消息头中X-Subject-Token的值。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| [数组元素] | Array of ServicePodEventResponse objects | 参数解释: 服务Pod事件列表。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| count | Integer | 参数解释: 事件发生次数。 取值范围: 不涉及。 |
| first_timestamp | String | 参数解释: 首次发生时间。 取值范围: 不涉及。 |
| last_timestamp | String | 参数解释: 最近发生时间。 取值范围: 不涉及。 |
| message | String | 参数解释: 事件信息。 取值范围: 不涉及。 |
| reason | String | 参数解释: 事件名称。 取值范围: 不涉及。 |
| reporting_component | String | 参数解释: 上报该事件的k8s组件名。 取值范围: 不涉及。 |
| type | String | 参数解释: 事件类型。 取值范围: Normal/Warning。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: ModelArts错误码。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 具体错误信息。 取值范围: 不涉及。 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: ModelArts错误码。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 具体错误信息。 取值范围: 不涉及。 |
状态码:403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: ModelArts错误码。 取值范围: 不涉及。 |
| error_msg | String | 参数解释: 具体错误信息。 取值范围: 不涉及。 |
状态码:404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 资源未找到。 |
错误码
请参见错误码。