华为云计算 云知识 查询Job状态ShowJobInfos
查询Job状态ShowJobInfos

 

功能介绍

查询Job的执行状态。

对于创建 裸金属服务器 、挂卸卷等异步API,命令下发后,会返回“job_id”,通过“job_id”可以查询任务的执行状态。

调试

您可以在API Explorer中调试该接口。

URI

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

参数说明请参见表1。

表1 参数说明

参数

是否必选

描述

project_id

项目ID。

获取方式请参见获取项目ID

job_id

Job ID。

请求参数

请求示例

查询job_id为2c9eb2c5544cbf6101544f0635672b60的Job状态。
GET https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/jobs/2c9eb2c5544cbf6101544f0635672b60

响应参数

参数

参数类型

描述

status

String

Job的状态。

  • SUC CES S:成功
  • RUNNING:运行中
  • FAIL:失败
  • INIT:正在初始化
  • PENDING_PAYMENT:包年/包月订单待支付

entities

Object

Job操作的对象。请参见表2。

根据不同Job类型,显示不同的内容。裸金属服务器相关操作显示server_id;网卡相关操作显示nic_id;有子Job时为子Job的详情。

job_id

String

Job ID。

job_type

String

Job的类型,包含以下类型:

  • baremetalBatchCreate:批量创建裸金属服务器
  • baremetalBatchOperate:批量修改裸金属服务器电源状态
  • baremetalVolumeBootReinstallOs:重装快速发放裸金属服务器操作系统
  • baremetalReinstallOs:重装本地盘裸金属服务器操作系统
  • baremetalAttachVolume:挂载单个磁盘
  • baremetalDetachVolume:卸载单个磁盘

begin_time

String

开始时间。

时间戳格式为ISO 8601,例如:2019-04-25T20:04:47.591Z

end_time

String

结束时间。

时间戳格式为ISO 8601,例如:2019-04-26T20:04:47.591Z

error_code

String

Job执行失败时的错误码。

fail_reason

String

Job执行失败时的错误原因。

message

String

出现错误时,返回的错误消息。

code

String

出现错误时,返回的错误码。

错误码和其对应的含义请参考状态码

表2 entities字段数据结构说明

参数

参数类型

描述

sub_jobs_total

Integer

子任务数量。没有子任务时为0。

sub_jobs

Array of objects

每个子任务的执行信息。没有子任务时为空列表。请参见表3。

表3 sub_jobs字段数据结构说明

参数

参数类型

描述

status

String

Job的状态。

  • SUCCESS:成功
  • RUNNING:运行中
  • FAIL:失败
  • INIT:正在初始化

entities

Array of objects

Job操作的对象。根据不同Job类型,显示不同的内容。裸金属服务器相关操作显示server_id;网卡相关操作显示nic_id。

请参见表4。

job_id

String

Job ID。

job_type

String

Job的类型,包含以下类型:

  • baremetalSingleCreate:创建单个裸金属服务器
  • baremetalSingleOperate:修改单个裸金属服务器电源状态

begin_time

String

开始时间。

时间戳格式为ISO 8601,例如:2019-04-25T20:04:47.591Z

end_time

String

结束时间。

时间戳格式为ISO 8601,例如:2019-04-26T20:04:47.591Z

error_code

String

Job执行失败时的错误码。

fail_reason

String

Job执行失败时的错误原因。

message

String

出现错误时,返回的错误消息。

code

String

出现错误时,返回的错误码。

错误码和其对应的含义请参考状态码

表4 entities字段数据结构说明

参数

参数类型

描述

server_id

String

裸金属服务器相关操作显示server_id。

nic_id

String

网卡相关操作显示nic_id。

响应示例

{
    "status": "SUCCESS",
    "entities": {
        "sub_jobs_total": 1,
        "sub_jobs": [
            {
                "status": "SUCCESS",
                "entities": {
                    "server_id": "bae51750-0089-41a1-9b18-5c777978ff6d"
                },
                "job_id": "2c9eb2c5544cbf6101544f0635672b60",
                "job_type": "baremetalSingleCreate",
                "begin_time": "2019-04-25T20:04:47.591Z",
                "end_time": "2019-04-25T20:08:21.328Z",
                "error_code": null,
                "fail_reason": null
            }
        ]
    },
    "job_id": "2c9eb2c5544cbf6101544f0602af2b4f",
    "job_type": "baremetalBatchCreate",
    "begin_time": "2019-04-25T20:04:34.604Z",
    "end_time": "2019-04-25T20:08:41.593Z",
    "error_code": null,
    "fail_reason": null
}

返回值

正常返回值:

返回值

说明

200

服务器已成功处理了请求。

其他返回值请参考状态码

错误码

请参考错误码

上一篇:IOZone是什么 下一篇:电力行业信息化年会 华为解读“低碳、安全、发展”新思路