文档首页> 分布式缓存服务 DCS> API参考（巴黎区域）> API V2（推荐）> 后台任务管理> 查询租户Job执行结果
更新时间：2023-12-13 GMT+08:00
查看PDF

查询租户Job执行结果

功能介绍

查询租户Job执行结果

URI

GET /v2/{project_id}/jobs/{job_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取方法请参见获取项目ID。

job_id

是

String

任务ID。

请求参数

无

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

job_id

String

任务ID。

job_type

String

Job类型，取值范围：

  • masterStandbySwapJob：主备倒换任务

  • modifyClientIpTransJob：修改源IP透传

枚举值：

  • masterStandbySwapJob

  • modifyClientIpTransJob

status

String

Job状态。

枚举值：

  • INIT

  • RUNNING

  • SUCCESS

  • FAIL

begin_time

String

Job开始时间戳，单位为ms，格式为:1684191545379。

end_time

String

Job开始时间戳，单位为ms，格式为:1684191548248。

fail_reason

String

失败原因。

状态码： 400

表3 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

最大长度：1024

状态码： 401

表4 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

最大长度：1024

状态码： 403

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

最大长度：1024

状态码： 404

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

最大长度：1024

状态码： 500

表7 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

最大长度：1024

请求示例

GET https://{dcs_endpoint}/v2/a4d31cb6-3d72-4fdc-8ec9-6e3a41e47f71/instances/5560df16-cebf-4473-95c4-d1b573c16e79/tasks/8abf6e1e72c12e7c0172c15b508500aa/progress

响应示例

状态码： 200

查询后台任务详情成功。

{
  "job_id" : "ff8080818822bbf70188235afc24141a",
  "job_type" : "masterStandbySwapJob",
  "status" : "SUCCESS",
  "begin_time" : "1684191545379",
  "end_time" : "1684191548248",
  "fail_reason" : null
}

状态码： 400

非法请求。

{
  "error_code" : "111400063",
  "error_msg" : "Invalid {0} parameter in the request."
}

状态码

状态码

描述

200

查询后台任务详情成功。

400

非法请求。

401

认证信息非法。

403

请求被拒绝访问。

404

所请求的资源不存在。

500

内部服务错误。

错误码

请参见错误码。

父主题： 后台任务管理