# 查询批处理作业详情 - ShowSparkJob #### 功能介绍 该API用于根据批处理作业的id查询作业详情。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DLI&api=ShowSparkJob)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限及授权项说明](https://support.huaweicloud.com/api-dli/dli_02_0375.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 Action | 访问级别 Access Level | 资源类型（\*为必须） Resource Type (\*: required) | 条件键 Condition Key | 别名 Alias | 依赖的授权项 Dependencies | |:---|:---|:---|:---|:---|:---| | dli:jobs:get | read | jobs \* | - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | - | - | #### URI - URI格式： GET /v2.0/{project_id}/batches/{batch_id} - 参数说明 表1URI参数说明 | 参数名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目编号，用于资源隔离。获取方式请参考[获取项目ID](https://support.huaweicloud.com/api-dli/dli_02_0183.html)。 示例: 48cc2c48765f481480c7db940d6409d1 **约束限制：** 无 **取值范围：** 只能由英文字母和数字组成，且长度为\[1-64\]个字符。 **默认取值：** 无 | | batch_id | 是 | String | **参数解释：** 批处理作业的ID。获取方式请参考[查询批处理作业列表 - ListSparkJobs](https://support.huaweicloud.com/api-dli/dli_02_0125.html)响应参数中的appId。 示例: 0a324461-d9d9-45da-a52a-3b3c7a3d809e **约束限制：** 匹配正则表达式'\^\[0-9a-fA-F\]{8}-\[0-9a-fA-F\]{4}-\[0-9a-fA-F\]{4}-\[0-9a-fA-F\]{4}-\[0-9a-fA-F\]{12}$'的字符串 **取值范围：** 无 **默认取值：** 无 | #### 请求消息 无请求参数。 #### 响应消息 表2响应参数 | 参数名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | id | 否 | String | **参数解释：** 批处理作业的ID，采用UUID（通用唯一识别码）格式。 **取值范围：** 无 | | appId | 否 | String | **参数解释：** 批处理作业的后台app id。 **取值范围：** 无 | | name | 否 | String | **参数解释：** 批处理作业名称。 **取值范围：** 无 | | owner | 否 | String | **参数解释：** 批处理作业所属用户。 **取值范围：** 无 | | proxyUser | 否 | String | **参数解释：** 批处理作业所属代理用户（资源租户）。 **取值范围：** 无 | | state | 否 | String | **参数解释：** 批处理作业的状态。 **取值范围：** - starting：正在启动 - running：正在执行任务 - dead：session已退出 - success：session停止成功 - recovering：正在恢复 | | kind | 否 | String | **参数解释：** 批处理作业类型，只支持spark类型参数。 **取值范围：** 无 | | log | 否 | Array of Strings | **参数解释：** 显示当前批处理作业的最后10条记录。 **取值范围：** 无 | | sc_type | 否 | String | **参数解释：** 计算资源类型。目前可接受参数A, B, C。用户自定义时返回CUSTOMIZED。 **取值范围：** - A：物理资源：8核32G内存， - driverCores：2； - executorCores：1； - driverMemory：7G； - executorMemory：4G； - numExecutor：6。 - B：物理资源：16核64G内存 - driverCores：2； - executorCores：2； - driverMemory：7G； - executorMemory：8G； - numExecutor：7。 - C：物理资源：32核128G内存 - driverCores：4； - executorCores：2； - driverMemory：15G； - executorMemory：8G； - numExecutor：14。 | | cluster_name | 否 | String | **参数解释：** 批处理作业所在队列。 **取值范围：** 无 | | queue | 否 | String | **参数解释：** 批处理作业所在队列。 **取值范围：** 无 | | create_time | 否 | Long | **参数解释：** 批处理作业的创建时间。是单位为"毫秒"的时间戳。 **取值范围：** 无 | | update_time | 否 | Long | **参数解释：** 批处理作业的更新时间。是单位为"毫秒"的时间戳。 **取值范围：** 无 | | feature | 否 | String | **参数解释：** 作业特性。表示用户作业使用的Spark镜像类型。 **取值范围：** - basic：表示使用DLI提供的基础Spark镜像。 - custom：表示使用用户自定义的Spark镜像。 | | spark_version | 否 | String | **参数解释：** 作业使用spark组件的版本号，在"feature"为"basic"或"ai"时填写，若不填写，则使用默认的spark组件版本号2.3.2。 **取值范围：** 无 | | image | 否 | String | **参数解释：** 自定义镜像。格式为：组织名/镜像名:镜像版本。 **取值范围：** 当用户设置"feature"为"custom"时，该参数生效。用户可通过与"feature"参数配合使用，指定作业运行使用自定义的Spark镜像。 关于如何使用自定义镜像，请参考《[数据湖探索用户指南](https://support.huaweicloud.com/usermanual-dli/dli_01_0494.html)》。 | | req_body | 否 | String | **参数解释：** 请求参数详情。 **取值范围：** 无 | #### 请求示例 无 #### 响应示例 ``` { "id": "0a324461-d9d9-45da-a52a-3b3c7a3d809e", "appId": "", "name": "", "owner": "", "proxyUser": "", "state": "starting", "kind":"spark", "log": [ "stdout: ", "stderr: ", "YARN Diagnostics: " ], "sc_type": "A", "cluster_name": "test", "queue": "test", "create_time": 1531906043036, "update_time": 1531906043036 } ``` #### 状态码 状态码如[表3]所示。 表3状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询成功。 | | 400 | 请求错误。 | | 500 | 内部服务器错误。 | #### 错误码 调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见[错误码](https://support.huaweicloud.com/api-dli/dli_02_0056.html)。