文档首页/ MapReduce服务 MRS/ API参考/ API V2/ 作业管理接口/ 查询单个作业信息-ShowSingleJob
更新时间：2026-01-12 GMT+08:00
查看PDF
分享

查询单个作业信息-ShowSingleJob

功能介绍

在MRS集群中查询指定作业的详细信息。

接口约束

无。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和受限项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    mrs:cluster:listJobs

    List

    cluster *

    • g:ResourceTag/<tag-key>

    • g:EnterpriseProjectId
    • mrs:job:list

    -

URI

  • URI格式

    GET /v2/{project_id}/clusters/{cluster_id}/job-executions/{job_execution_id}

  • 参数说明
    表1 URI参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    是

    String

    参数解释：

    项目编号。获取方法，请参见获取项目ID。

    约束限制：

    不涉及

    取值范围：

    只能由英文字母和数字组成，且长度为[1-64]个字符。

    默认取值：

    不涉及

    cluster_id

    是

    String

    参数解释：

    集群ID。如果指定集群ID，则获取该集群做过补丁更新的最新版本元数据。获取方法，请参见获取集群ID。

    约束限制：

    不涉及

    取值范围：

    只能由英文字母、数字以及“_”和“-”组成，且长度为[1-64]个字符。

    默认取值：

    不涉及

    job_execution_id

    是

    String

    参数解释：

    作业ID。获取方法，请参见获取作业ID。

    约束限制：

    不涉及

    取值范围：

    不涉及

    默认取值：

    不涉及

请求参数

无。

响应参数

状态码：202

表2 响应参数说明

参数名

参数类型

说明

job_detail

JobQueryBean object

参数解释：

作业详细信息，具体参数说明请参考表3。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表3 作业信息参数说明

参数名

参数类型

说明

job_id

String

参数解释：

作业ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

user

String

参数解释：

提交作业的用户名称。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

job_name

String

参数解释：

作业名称。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

job_result

String

参数解释：

作业最终结果。

约束限制：

不涉及

取值范围：

  • FAILED：执行失败的作业。
  • KILLED：执行中被手动终止的作业。
  • UNDEFINED：正在执行的作业。
  • SUCCEEDED：执行成功的作业。

默认取值：

不涉及

job_state

String

参数解释：

作业执行状态。

约束限制：

不涉及

取值范围：

  • FAILED：失败
  • KILLED：已终止
  • NEW：已创建
  • NEW_SAVING：已创建保存中
  • SUBMITTED：已提交
  • ACCEPTED：已接受
  • RUNNING：运行中
  • FINISHED：已完成

默认取值：

不涉及

job_progress

Float

参数解释：

作业执行进度。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

job_type

String

参数解释：

作业类型。

约束限制：

不涉及

取值范围：

  • MapReduce：提供快速并行处理大量数据的能力，是一种分布式数据处理模式和执行环境，MRS支持提交MapReduce Jar程序。

  • SparkSubmit：提交Spark Jar和Spark Python程序，运行Spark Application计算和处理用户数据。

  • SparkPython：该类型作业将转换为SparkSubmit类型提交，MRS控制台界面的作业类型展示为SparkSubmit，通过接口查询作业列表信息时作业类型请选择SparkSubmit。

  • HiveScript：是建立在Hadoop基础上的开源的数据仓库，MRS支持提交HiveScript脚本。

  • HiveSql：是建立在Hadoop基础上的开源的数据仓库，MRS支持直接执行Hive SQL语句。

  • DistCp：是Hadoop中的一个工具，用于在分布式文件系统（如 HDFS）之间高效地导入导出数据。

  • SparkScript：提交SparkScript脚本，批量执行Spark SQL语句。

  • SparkSql：使用Spark提供的类似SQL的Spark SQL语句，实时查询和分析用户数据。

  • Flink：提供一个分布式大数据处理引擎，可对有限数据流和无限数据流进行有状态计算。

默认取值：

不涉及

started_time

Long

参数解释：

作业开始执行时间。单位：毫秒。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

submitted_time

Long

参数解释：

作业提交时间。单位：毫秒。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

finished_time

Long

参数解释：

作业完成时间。单位：毫秒。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

elapsed_time

Long

参数解释：

作业执行时长。单位：毫秒。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

arguments

String

参数解释：

运行参数。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

properties

String

参数解释：

配置参数，用于传-d参数。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

launcher_id

String

参数解释：

真实作业编号。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

app_id

String

参数解释：

实际作业编号。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

tracking_url

String

参数解释：

日志链接地址。当前仅SparkSubmit作业支持该参数。该参数基于集群的EIP访问集群中的Yarn WebUI页面，用户如果在VPC界面解绑EIP，MRS服务侧数据会因为未更新导致该参数引用旧EIP导致访问失败，可通过对集群重新绑定EIP来修复该问题。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

queue

String

参数解释：

作业的资源队列类型。

约束限制：

不涉及

取值范围：

只能由英文字母、数字以及“-”和“_”组成，且长度为[1-64]个字符，默认为‘default’。

默认取值：

不涉及

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

约束限制：

不涉及

取值范围：

400：操作执行失败

默认取值：

不涉及

error_msg

String

参数解释：

错误描述。

约束限制：

不涉及

取值范围：

400：操作执行失败

默认取值：

不涉及

请求示例

查询单个作业请求示例

GET https://{endpoint}/v2/{project_id}/clusters/{cluster_id}/job-executions/{job_execution_id}

响应示例

状态码： 202

查询单个作业信息成功

{
  "job_detail" : {
    "job_id" : "431b135e-c090-489f-b1db-0abe3822b855",
    "user" : "xxxx",
    "job_name" : "pyspark1",
    "job_result" : "SUCCEEDED",
    "job_state" : "FINISHED",
    "job_progress" : 100,
    "job_type" : "SparkSubmit",
    "started_time" : 1564626578817,
    "submitted_time" : 1564626561541,
    "finished_time" : 1564626664930,
    "elapsed_time" : 86113,
    "queue" : "default",
    "arguments" : "[--class, org.apache.spark.examples.SparkPi, --driver-memory, 512MB, --num-executors, 1, --executor-cores, 1, --master, yarn-cluster, s3a://obs-test/jobs/spark/spark-examples_2.11-2.1.0.jar, 10000]",
    "launcher_id" : "application_1564622673393_0006",
    "app_id" : "application_1564622673393_0007",
    "properties" : "{}"
  }
}

状态码： 400

查询单个作业信息失败

{
  "error_msg" : "查询作业失败",
  "error_code" : "0162"
}

状态码

状态码请参见状态码。

错误码

请参见错误码。

父主题： 作业管理接口