# 查询job的状态详情 - ShowJobDetail #### 功能介绍 用于查询SFS Turbo异步API的执行状态。例如：可使用调用创建并绑定LDAP配置接口时返回的jobId，通过该接口查询job的执行状态。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=ShowJobDetail)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfsturbo/sfsturbo_02_0079.html)。 #### 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 | 子任务列表。 | 表5GetSubJobDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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" : "b959dfbb-1a2b-3c4d-5e6f-8930ec3a87b7", "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 | 内部错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。