文档首页/ 企业交换机 ESW/ API参考/ 企业交换机/ 查询任务的执行状态 - ListResourceJobs
更新时间：2025-11-20 GMT+08:00
查看PDF
分享

查询任务的执行状态 - ListResourceJobs

功能介绍

查询租户指定资源相关的任务信息列表，COMPLETED表示任务已成功完成，RUNNING表示任务正在执行中，FAILED表示任务执行失败。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

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格式。

  • 取值范围：不涉及。

  • 默认取值：不涉及。
表3 Job

参数

参数类型

描述

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。

  • 约束限制：不涉及。

  • 取值范围：不涉及。

  • 默认取值：不涉及。
表4 PageInfo

参数

参数类型

描述

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操作正常返回，更多状态码请参见状态码。

{
  "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操作正常返回，更多状态码请参见状态码。

错误码

请参见错误码。

父主题： 企业交换机

相关文档