文档首页> MapReduce服务 MRS> API参考(巴黎区域)> API V2> 作业对象接口> 查询单个作业信息
更新时间：2022-12-14 GMT+08:00
查看PDF

查询单个作业信息

功能介绍

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

URI

  • URI格式

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

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

    名称

    是否必选

    说明

    project_id

    是

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

    cluster_id

    是

    集群ID。获取方法，请参见获取集群ID。

    job_execution_id

    是

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

请求消息

请求参数

无。

响应参数

表2 响应参数说明

参数名

参数类型

说明

job_detail

Object

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

参数名

参数类型

说明

job_id

String

作业ID。

user

String

提交作业的用户名称。

job_name

String

作业名称，只能由字母、数字、中划线和下划线组成，并且长度为1～64个字符。

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
  • SparkSubmit
  • SparkSubmit：SparkPython类型的作业在查询时作业类型请选择SparkSubmit。
  • HiveScript
  • HiveSql
  • DistCp，导入、导出数据。
  • SparkScript
  • SparkSql
  • Flink

started_time

Long

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

submitted_time

Long

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

finished_time

Long

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

elapsed_time

Long

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

arguments

Array

运行参数。最多为4096字符，不能包含;|&>'<$!\\特殊字符，可为空。

properties

Object

配置参数，用于传-d参数。最多为2048字符，不能包含><|'`&!\特殊字符，可为空。

launcher_id

String

Launcher作业编号。

app_id

String

实际作业编号。

示例

  • 请求示例

    无。

  • 响应示例
    • 成功示例
      {
    "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, obs://obs-test/jobs/spark/spark-examples_2.11-2.1.0.jar, 10000]",
        "launcher_id": "application_1564622673393_0006",
        "app_id": "application_1564622673393_0007",
        "properties": "{}"
    }
}
    • 失败示例
      {
"error_msg":"查询作业失败",
"error_code":"0162"
}

状态码

状态码请参见状态码。

父主题： 作业对象接口