更新时间:2021-11-30 GMT+08:00
分享

查询job状态

功能介绍

查询job的执行状态。 对于创建保护组、删除保护组、创建保护实例、删除保护实例、创建复制对、删除复制对等异步API,命令下发后,会返回job_id,通过job_id可以查询任务的执行状态。

接口约束

调试

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

job_id

String

job ID

project_id

String

项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

status

String

Job的状态。 SUCCESS:成功。 RUNNING:运行中。 FAIL:失败。 INIT:正在初始化。

枚举值:

  • SUCCESS

  • RUNNING

  • FAIL

  • INIT

entities

JobEntities object

Job操作的对象。

job_id

String

Job ID。

job_type

String

Job的类型。createProtectionGroupNoCG:创建保护组。deleteProtectionGroupNoCG:删除保护组。startProtectionGroupNoCG :保护组开始保护。reprotectProtectionGroupNoCG :保护组重保护。stopProtectionGroupNoCG :保护组停止保护。failoverProtectionGroupNoCG :保护组故障切换。reverseProtectionGroupNoCG:保护组切换。createProtectedInstanceNoCG:创建保护实例。deleteProtectedInstanceNoCG:删除保护实例。attachReplicationPairNew:保护实例挂载复制对。detachReplicationPairNew:保护实例卸载复制对。addNicNew:保护实例添加网卡。deleteNicNew:保护实例删除网卡。resizeProtectedInstanceNew:保护实例变更规格。createReplicationPairNoCG:创建复制对。deleteReplicationPairNoCG:删除复制对。expandReplicationPairNew:复制对扩容。createDisasterRecoveryDrill:创建容灾演练。deleteDisasterRecoveryDrill:删除容灾演练。

begin_time

String

开始时间。默认格式为:"yyyy-MM-dd'T'HH:mm:ss.SSSZ",例:"2019-04-01T12:00:00.000Z"。

end_time

String

结束时间。默认格式为:"yyyy-MM-dd'T'HH:mm:ss.SSSZ",例:"2019-04-01T12:00:00.000Z"。

error_code

String

Job执行失败时的错误码。

fail_reason

String

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

表4 JobEntities

参数

参数类型

描述

replication_pair_id

String

复制对ID

volume_ids

String

组成复制对的云硬盘ID

server_group_id

String

保护组ID

protected_instance_id

String

保护实例ID

native_server_id

String

容灾站点服务器ID

nic_id

String

网卡ID

sub_jobs

Array of SubJobParams objects

子Job信息

表5 SubJobParams

参数

参数类型

描述

status

String

Job的状态。 SUCCESS:成功。 RUNNING:运行中。 FAIL:失败。 INIT:正在初始化。

枚举值:

  • SUCCESS

  • RUNNING

  • FAIL

  • INIT

entities

SubJobEntities object

Job操作的对象。

job_id

String

Job ID。

job_type

String

Job的类型。createProtectionGroupNoCG:创建保护组。deleteProtectionGroupNoCG:删除保护组。startProtectionGroupNoCG :保护组开始保护。reprotectProtectionGroupNoCG :保护组重保护。stopProtectionGroupNoCG :保护组停止保护。failoverProtectionGroupNoCG :保护组故障切换。reverseProtectionGroupNoCG:保护组切换。createProtectedInstanceNoCG:创建保护实例。deleteProtectedInstanceNoCG:删除保护实例。attachReplicationPairNew:保护实例挂载复制对。detachReplicationPairNew:保护实例卸载复制对。addNicNew:保护实例添加网卡。deleteNicNew:保护实例删除网卡。resizeProtectedInstanceNew:保护实例变更规格。createReplicationPairNoCG:创建复制对。deleteReplicationPairNoCG:删除复制对。expandReplicationPairNew:复制对扩容。createDisasterRecoveryDrill:创建容灾演练。deleteDisasterRecoveryDrill:删除容灾演练。

begin_time

String

开始时间。默认格式为:"yyyy-MM-dd'T'HH:mm:ss.SSSZ",例:"2019-04-01T12:00:00.000Z"。

end_time

String

结束时间。默认格式为:"yyyy-MM-dd'T'HH:mm:ss.SSSZ",例:"2019-04-01T12:00:00.000Z"。

error_code

String

Job执行失败时的错误码。

fail_reason

String

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

表6 SubJobEntities

参数

参数类型

描述

replication_pair_id

String

复制对ID

volume_ids

String

组成复制对的云硬盘ID

server_group_id

String

保护组ID

protected_instance_id

String

保护实例ID

native_server_id

String

容灾站点服务器ID

nic_id

String

网卡ID

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表8 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 401

表9 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表10 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 403

表11 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表12 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 405

表13 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表14 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 406

表15 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表16 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 407

表17 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表18 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 408

表19 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表20 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 409

表21 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表22 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 500

表23 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表24 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 501

表25 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表26 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 502

表27 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表28 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 503

表29 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表30 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码: 504

表31 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构

表32 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

请求示例

GET https://{endpoint}/v1/{project_id}/jobs/0000000062db92d70162db9d200f000a

响应示例

状态码: 200

OK

{
  "status" : "SUCCESS",
  "entities" : {
    "server_group_id" : "a59d008e-4bad-4bf3-9b17-6cc25e7da483"
  },
  "job_id" : "0000000062db92d70162db9d200f000a",
  "job_type" : "createProtectionGroupNoCG",
  "begin_time" : "2018-04-19T01:55:30.443Z",
  "end_time" : "2018-04-19T01:55:45.493Z",
  "error_code" : null,
  "fail_reason" : null
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

405

Method Not Allowed

406

Not Acceptable

407

Proxy Authentication Required

408

Request Timeout

409

Conflict

500

Internal Server Error

501

Not Implemented

502

Bad Gateway

503

Service Unavailable

504

Gateway Timeout

错误码

请参见错误码

相关文档