# 查询任务的执行状态 - ListResourceJobs
#### 功能介绍
查询租户指定资源相关的任务信息列表，COMPLETED表示任务已成功完成，RUNNING表示任务正在执行中，FAILED表示任务执行失败。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/esw/doc?api=ListResourceJobs&version=v2)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-esw/esw_api0011.html)。
| 授权项                             | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| esw:job:listResourceRelatedJobs | List | -           | -   | -  | -      |
   
#### URI
GET /v3/{project_id}/l2cg/resources/{resource_id}/jobs
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                             |
|:---|:---|:---|:---|
| project_id  | 是    | String | - 参数解释：ESW实例所属项目ID。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。        |
| resource_id | 是    | String | - 参数解释：ESW实例的唯一标识。 - 约束限制：带"-"的UUID格式。 - 取值范围：不涉及。 - 默认取值：不涉及。 |
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数         | 参数类型                                                    | 描述                                                     |
|:---|:---|:---|
| jobs       | Array of [Job] objects | - 参数解释：查询任务列表的响应体。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。 |
| page_info  | [PageInfo] object | - 参数解释：分页信息。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。       |
| request_id | String                                                  | - 参数解释：请求的唯一标识。 - 约束限制：UUID格式。 - 取值范围：不涉及。 - 默认取值：不涉及。 |
   
 表3Job 
| 参数            | 参数类型   | 描述                                                                                                           |
|:---|:---|:---|
| id            | String | - 参数解释：任务的唯一标识。 - 约束限制：带"-"的UUID格式。 - 取值范围：不涉及。 - 默认取值：不涉及。                                                  |
| name          | String | - 参数解释：当前任务的名称。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。                                                          |
| status        | String | - 参数解释：任务状态。 - 约束限制：不涉及。 - 取值范围： - RUNNING：运行中 - FAILED：失败 - COMPLETED：已完成 - 默认取值：不涉及。                       |
| begin_time    | String | - 参数解释：任务开始时间。 - 约束限制：UTC时间，格式为yyyy-MM-ddTHH:mm:ss。 - 取值范围：不涉及。 - 默认取值：不涉及。                                  |
| end_time      | String | - 参数解释：任务结束时间。 - 约束限制： - UTC时间，格式为yyyy-MM-ddTHH:mm:ss。 - 仅在任务状态为FAILED或者COMPLETED时可见 - 取值范围：不涉及。 - 默认取值：不涉及。 |
| process       | String | - 参数解释：任务当前进度，以百分比展示。 - 约束限制：仅在任务状态为RUNNING时可见。 - 取值范围：不涉及。 - 默认取值：不涉及。                                      |
| fail_reason   | String | - 参数解释：任务的失败原因。 - 约束限制：仅在任务状态为FAILED时显示。 - 取值范围：不涉及。 - 默认取值：不涉及。                                             |
| resource_id   | String | - 参数解释：任务当前关联的资源ID。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。                                                      |
| resource_name | String | - 参数解释：任务当前关联的资源名称。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。                                                      |
| resource_type | String | - 参数解释：任务当前关联的资源类型。 - 约束限制：不涉及。 - 取值范围： - instance：ESW实例 - 默认取值：不涉及。                                         |
| project_id    | String | - 参数解释：ESW实例所属项目ID。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。                                                      |
   
 表4PageInfo 
| 参数              | 参数类型    | 描述                                                                         |
|:---|:---|:---|
| next_marker     | String  | - 参数解释：当前页的最后一条记录，最后一页时无next_marker字段。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。 |
| previous_marker | String  | - 参数解释：分页查询起始的资源ID，为空时查询第一页。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。           |
| current_count   | Integer | - 参数解释：当前页记录总数。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。                        |
   
#### 请求示例
```
GET https://{{endpoint}}/v3/88104fcc62a640bfa0a0bf687607621c/l2cg/resources/3bbe7af1-1355-4e41-9fee-721bd80de2ab/jobs
```
#### 响应示例
**状态码：200**
GET操作正常返回，更多状态码请参见[状态码](https://support.huaweicloud.com/api-esw/esw_api0020.html)。
```
{
  "request_id" : "f8ef8704d8eb6a13988a01f4e37307fc",
  "jobs" : [ {
    "name" : "DeleteHAInstance",
    "id" : "25578d6b-7394-48fd-b647-3308c476cb6d",
    "status" : "COMPLETED",
    "resource_id" : "3bbe7af1-1355-4e41-9fee-721bd80de2ab",
    "resource_name" : "esw-fee1",
    "resource_type" : "instance",
    "project_id" : "88104fcc62a640bfa0a0bf687607621c",
    "begin_time" : "2025-10-22T03:25:41",
    "end_time" : "2025-10-22T03:25:43"
  }, {
    "name" : "CreateHAInstance",
    "id" : "71c1c3fc-c2ab-4d78-8964-b38b270dcde8",
    "status" : "FAILED",
    "resource_id" : "3bbe7af1-1355-4e41-9fee-721bd80de2ab",
    "resource_name" : "esw-fee1",
    "resource_type" : "instance",
    "project_id" : "88104fcc62a640bfa0a0bf687607621c",
    "begin_time" : "2025-10-22T03:23:13",
    "end_time" : "2025-10-22T03:25:01",
    "fail_reason" : "WaitCreateServerJobTask Failed"
  } ],
  "page_info" : {
    "previous_marker" : "25578d6b-7394-48fd-b647-3308c476cb6d",
    "current_count" : 2
  }
}
```
#### 状态码
| 状态码 | 描述                                                                                 |
|:---|:---|
| 200 | GET操作正常返回，更多状态码请参见[状态码](https://support.huaweicloud.com/api-esw/esw_api0020.html)。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-esw/ErrorCode.html)。