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

查询job的状态详情 - ShowJobDetail

功能介绍

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

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

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：表示成功。

  • failed：表示失败。

  • waiting：表示等待执行。

  • running：表示运行中。

job_id

String

job的ID。

job_type

String

job的类型。

枚举值：

  • create_share：表示创建文件系统

  • hpc_create_share：表示创建文件系统

  • delete_share：表示删除文件系统

  • extend_share：表示扩容文件系统

  • change_security_group：表示修改文件系统绑定的安全组

  • create_obs_target：表示绑定后端存储

  • delete_obs_target：表示删除后端存储

  • add_ad_domain：表示加入AD域

  • change_ad_domain：表示修改AD域

  • quit_ad_domain：表示退出AD域

  • bind_ldap：表示创建并绑定LDAP配置

  • unbind_ldap：表示删除LDAP配置

  • update_ldap：表示修改LDAP配置

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

job的状态。

枚举值：

  • success：表示成功。

  • failed：表示失败。

  • waiting：表示等待执行。

  • running：表示运行中。

job_id

String

子任务的ID。

job_type

String

子任务的类型。

枚举值：

  • create_share：表示创建文件系统

  • hpc_create_share：表示创建文件系统

  • delete_share：表示删除文件系统

  • extend_share：表示扩容文件系统

  • change_security_group：表示修改文件系统绑定的安全组

  • create_obs_target：表示绑定后端存储

  • delete_obs_target：表示删除后端存储

  • add_ad_domain：表示加入AD域

  • change_ad_domain：表示修改AD域

  • quit_ad_domain：表示退出AD域

  • bind_ldap：表示创建并绑定LDAP配置

  • unbind_ldap：表示删除LDAP配置

  • update_ldap：表示修改LDAP配置

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

内部错误

错误码

请参见错误码。

父主题： 任务管理

相关文档