更新时间:2024-04-16 GMT+08:00

异步任务查询

功能介绍

该接口为扩展接口,主要用于查询异步接口执行情况,比如查询导出镜像任务的执行状态。

URI

GET /v1/{project_id}/jobs/{job_id}

参数说明请参见表1
表1 参数说明

参数

是否必选

描述

project_id

项目ID

job_id

异步任务ID

请求消息

请求参数

请求示例

查询异步接口执行情况。

GET /v1/ac234de25c6741d2b1273da49eea1b9e/jobs/ff8080814dbd65d7014dbe0d84db0013

响应消息

  • 响应参数

    参数

    参数类型

    描述

    status

    String

    任务状态,目前取值如下:

    • SUCCESS:表示该任务执行已经结束,任务执行成功。
    • FAIL:表示该任务执行已经结束,任务执行失败。
    • RUNNING:表示该任务正在执行。
    • INIT:表示该任务还未执行,正在初始化。

    job_id

    String

    任务ID。

    job_type

    String

    任务类型。

    • imsCreateImageByInstance:云服务器制作镜像
    • imsImportImageJob:外部镜像文件创建镜像
    • imsImportOvaImageJob:外部Ova镜像文件创建镜像
    • imsVolumeCreateImageJob:数据盘制作数据盘镜像
    • imsImportDataImageJob:外部镜像文件制作数据盘镜像
    • imsCreateWholeImageByInstanceJob:云服务器制作整机镜像
    • imsCreateWholeImageByBackupJob:云备份或云服务器备份制作整机镜像
    • imsNativeImportImageJob:注册镜像
    • imsNativeExportImageJob:导出镜像
    • imsAddImageMembersJob:添加镜像成员
    • imsDelImageMembersJob:删除镜像成员
    • imsUpdateImageMembersJob:修改镜像成员
    • imsCopyImageInRegionJob:复制镜像

    begin_time

    String

    任务开始执行时间。格式为UTC时间。

    end_time

    String

    任务结束时间。格式为UTC时间。

    error_code

    String

    错误码。

    fail_reason

    String

    失败原因。

    entities

    Object

    任务自定义属性。

    任务正常时,返回镜像的ID;任务异常时,返回错误码和信息。

    详情请参见表2

    表2 entities字段数据结构说明

    参数

    参数类型

    描述

    image_id

    String

    镜像ID。

    current_task

    String

    当前任务名称。

    image_name

    String

    镜像名称。

    process_percent

    Double

    任务执行进度。

    results

    Array of result objects

    批量任务执行结果。详情请参见表3

    sub_jobs_result

    Array of objects

    子任务执行结果。详情请参见表4

    sub_jobs_list

    Array of string

    子任务id列表。

    表3 result字段数据结构说明

    参数

    参数类型

    描述

    image_id

    String

    镜像ID。

    project_id

    String

    项目ID。

    status

    String

    任务状态。

    表4 SubJobResult字段数据结构说明

    参数

    参数类型

    描述

    status

    String

    子任务状态,取值如下:

    • SUCCESS:表示该任务执行已经结束,任务执行成功。
    • FAIL:表示该任务执行已经结束,任务执行失败。
    • RUNNING:表示该任务正在执行。
    • INIT:表示该任务还未执行,正在初始化。

    job_id

    String

    子任务ID。

    job_type

    String

    子任务类型。

    begin_time

    String

    子任务开始执行时间。格式为UTC时间。

    end_time

    String

    子任务结束时间。格式为UTC时间。

    error_code

    String

    错误码。

    fail_reason

    String

    失败原因。

    entities

    Object

    子任务自定义属性。详情请参见表5

    • 任务正常时,返回镜像的ID。
    • 任务异常时,返回错误码和信息。
    表5 SubJobEntities字段数据结构说明

    参数

    参数类型

    描述

    image_id

    String

    镜像ID。

    image_name

    String

    镜像名称。

  • 响应样例
    STATUS CODE 200
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    {
        "status": "SUCCESS",
        "entities": {
            "image_id": "e9e91bff-14b6-4a0b-8377-4ed0813e3360",
            "image_name": "asdfasdfasdfas",
            "process_percent": 0.20,
            "current_task": "CreateImageByInstanceTask",
            "results": [{
                    "image_id": "49e9447f-7dff-41e0-8036-f66fe5488c8b",
                    "project_id": "089b2f9a3d80d3062f24c00ca4ed5cbd",
                    "status": "success"
                }
            ]
        },
        "job_id": "ff8080814dbd65d7014dbe0d84db0013",
        "job_type": "createImageByInstance",
        "begin_time": "04-Jun-2015 18:11:06:586",
        "end_time": "",
        "error_code": null,
        "fail_reason": null
    }
    

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。