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

查询作业列表信息

功能介绍

在MRS集群中查询作业列表信息。

URI

  • URI格式

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

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

    名称

    是否必选

    说明

    project_id

    是

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

    cluster_id

    是

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

请求消息

表2 请求参数说明

参数名

是否必选

参数类型

说明

job_name

否

String

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

job_type

否

String

作业类型。

  • MapReduce
  • SparkSubmit
  • SparkSubmit：SparkPython类型的作业在查询时作业类型请选择SparkSubmit。
  • HiveScript
  • HiveSql
  • DistCp，导入、导出数据。
  • SparkScript
  • SparkSql
  • Flink

job_state

否

String

作业运行状态。

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

job_result

否

String

作业运行结果。

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

limit

否

Integer

返回结果中每页显示条数，默认值为10。

offset

否

Integer

偏移量。

表示作业列表从该偏移量开始查询，默认值为1。

sort_by

否

String

返回结果的排序方式，默认值为desc。

  • asc：按升序排列
  • desc：按降序排列

submitted_time_begin

否

TimeStamp

查询该时间之后提交的作业，UTC的毫秒时间戳。例如：1562032041362。

submitted_time_end

否

TimeStamp

查询该时间之前提交的作业UTC的毫秒时间戳。例如：1562032041362。

响应参数

表3 响应参数说明

参数名

参数类型

说明

total_record

Integer

作业总条数。

job_list

Array

作业列表，参数说明请参见表4。
表4 作业信息参数说明

参数名

参数类型

说明

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
  • 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

实际作业编号。

示例

  • 请求示例

    无。

  • 响应示例
    • 成功示例
      {
	"total_record": 2,
	"job_list": [{
			"job_id": "981374c1-85da-44ee-be32-edfb4fba776c",
			"user": "xxxx",
			"job_name": "SparkSubmitTset",
			"job_result": "UNDEFINED",
			"job_state": "ACCEPTED",
			"job_progress": 0,
			"job_type": "SparkSubmit",
			"started_time": 0,
			"submitted_time": 1564714763119,
			"finished_time": 0,
			"elapsed_time": 0,
			"queue": "default",
			"arguments": "[--class, --driver-memory, --executor-cores, --master, yarn-cluster, obs://obs-test/hadoop-mapreduce-examples-3.1.1.jar, dddd]",
			"launcher_id": "application_1564622673393_0613",
			"properties": "{}"
		},
		{
			"job_id": "c54c8aa0-c277-4f83-8acc-521d85cfa32b",
			"user": "xxxx",
			"job_name": "SparkSubmitTset2",
			"job_result": "UNDEFINED",
			"job_state": "ACCEPTED",
			"job_progress": 0,
			"job_type": "SparkSubmit",
			"started_time": 0,
			"submitted_time": 1564714020099,
			"finished_time": 0,
			"elapsed_time": 0,
			"queue": "default",
			"arguments": "[--conf, yujjsjhe, --driver-memory, yueujdjjd, --master, yarn-cluster, obs://obs-test/hadoop-mapreduce-examples-3.1.1.jar]",
			"launcher_id": "application_1564622673393_0611",
			"properties": "{}"
		}
	]
}
    • 失败示例
      {
"error_msg":"查询作业列表失败",
"error_code":"0166"
}

状态码

状态码请参见状态码。

父主题： 作业对象接口