更新时间:2022-08-12 GMT+08:00

查询单个作业信息

功能介绍

在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"
      }

状态码

状态码请参见状态码