文档首页/ 高性能弹性文件服务 SFS Turbo/ API参考/ API/ 任务管理/ 查询job的状态详情
更新时间：2025-07-22 GMT+08:00
查看PDF
分享

查询job的状态详情

功能介绍

用于查询SFS Turbo异步API的执行状态。例如：可使用调用创建并绑定LDAP配置接口时返回的jobId，通过该接口查询job的执行状态。

URI

GET /v1/{project_id}/sfs-turbo/jobs/{job_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

job_id

是

String

job ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型

响应参数

状态码：200

表3 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表4 响应Body参数

参数

参数类型

描述

status

String

job的状态。success：成功。running：运行中。failed：失败。waiting：等待执行。

枚举值：

  • success

  • failed

  • waiting

  • running

job_id

String

job的ID。

job_type

String

job的类型。

begin_time

String

job开始时间。UTC时间，格式：'2016-01-02 15:04:05'。

end_time

String

job结束时间。UTC时间，格式：'2016-01-02 15:04:05'。

error_code

String

job执行失败时的错误码。

fail_reason

String

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

sub_jobs

Array of GetSubJobDetail objects

子任务列表。
表5 GetSubJobDetail

参数

参数类型

描述

status

String

子任务的状态。success：成功。running：运行中。failed：失败。waiting：等待执行。

job_id

String

子任务的ID。

job_type

String

子任务的类型。

begin_time

String

子任务开始时间。UTC时间，格式：'2016-01-02 15:04:05'

end_time

String

子任务结束时间。UTC时间，格式：'2016-01-02 15:04:05'

error_code

String

子任务执行失败时的错误码

fail_reason

String

子任务执行失败时的错误原因

状态码：400

表6 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表7 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码：404

表8 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表9 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码：500

表10 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表11 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

请求示例

无

响应示例

状态码：200

响应Body参数

{
  "job_id" : "26f6b565-xxxx-XXXX-xxxx-03f0bd975433",
  "status" : "success",
  "job_type" : "bind_ldap",
  "begin_time" : "2023-07-26 09:33:58",
  "end_time" : "2023-07-26 09:33:58"
}

状态码：400

客户端错误

{
  "errCode" : "SFS.TURBO.0001",
  "errMsg" : "parameter error"
}

状态码：404

资源不存在

{
  "errCode" : "SFS.TURBO.0001",
  "errMsg" : "parameter error"
}

状态码：500

内部错误

{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}

状态码

状态码

描述

200

响应Body参数

400

客户端错误

404

资源不存在

500

内部错误

错误码

请参见错误码。

父主题： 任务管理