5.5 委托管理
6.2.2 查询作业 exe 对象列表
状态码
状态码 描述
200 新增作业成功。
错误码
请参见错误码。
6.2.2 查询作业 exe 对象列表
功能介绍
查询所有作业的exe对象列表。该接口不兼容Sahara。
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
GET /v1.1/{project_id}/job-exes
表6-41 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目编号。获取方法，请参见获 取项目ID。
表6-42 Query 参数
参数 是否必选 参数类型 描述
page_size 否 String 分页查询每页返回的最大作业数
量。
取值范围：[1～100]
current_page 否 String 当前查询页码。
job_name 否 String 作业名称。
cluster_id 是 String 集群编号。
state 否 String 作业状态编码：
● -1：Terminated表示已终止 的作业状态
● 2：Running表示运行中的作 业状态
● 3：Completed表示已完成的 作业状态
● 4：Abnormal表示异常的作 业状态
id 否 String 作业执行对象的编号。
请求参数
无
响应参数
状态码： 200
表6-43 响应 Body 参数
参数 参数类型 描述
totalRecord Integer 作业列表总数。
job_execution
s Array of JobExeResult objects
作业列表。
表6-44 JobExeResult
参数 参数类型 描述
id String 作业ID。
create_at Long 作业创建时间，十三位时间戳。
update_at Long 作业更新时间，十三位时间戳。
tenant_id String 项目编号。获取方法，请参见获取项目ID。
job_id String 作业ID。
job_name String 作业名称。
start_time Long 作业执行开始时间，十三位时间戳。
end_time Long 作业执行结束时间，十三位时间戳。
cluster_id String 作业所属集群ID。
group_id String 作业执行组ID
jar_path String 执行程序jar包或sql文件地址。
input String 数据输入地址。
output String 数据输出地址。
job_log String 作业日志存储地址 job_type Integer 作业类型码。
● 1：MapReduce
● 2：Spark
● 3：Hive Script
● 4：HiveSQL（当前不支持）
● 5：DistCp
● 6：Spark Script
● 7：Spark SQL（该接口当前不支持）
file_action String 导入导出数据。
arguments String 程序执行的关键参数，该参数由用户程序内的函 数指定，MRS只负责参数的传入。该参数可为 空。
hql String HQL脚本语句。
参数 参数类型 描述
job_state Integer 作业状态编码：
● -1：Terminated表示已终止的作业状态
● 2：Running表示运行中的作业状态
● 3：Completed表示已完成的作业状态
● 4：Abnormal表示异常的作业状态 job_final_stat
us Integer 作业最终状态码。
● 0：未完成
● 1：执行错误，终止执行
● 2：执行完成并且成功
● 3：已取消 hive_script_pa
th String Hive脚本地址。
create_by String 创建作业的用户ID。
finished_step Integer 当前已完成的步骤数。
job_main_id String 作业主ID。
job_step_id String 作业步骤ID。
postpone_at Long 延迟时间，十三位时间戳。
step_name String 作业步骤名。
step_num Integer 步骤数量。
task_num Integer 任务数量。
update_by String 更新作业的用户ID。
spend_time Float 作业执行持续时间，单位：秒。
step_seq Integer 步骤序列号。
progress String 作业执行进度。
请求示例
查询作业exe对象列表请求示例
GET https://{endpoint}/v1.1/{project_id}/job-exes?
page_size=10¤t_page=1&state=3&job_name=myfirstjob&clusterId=20ca8601-72a2-4570-b788-2a20fec81a95
响应示例
状态码： 200
查询作业exe对象列表成功。
{ "totalRecord" : "14", "job_executions" : [ {
"id" : "669476bd-89d2-45aa-8f1a-872d16de377e", "create_at" : "1484641003707",
"update_at" : "1484641003707",
"tenant_id" : "3f99e3319a8943ceb15c584f3325d064", "job_id" : "",
"job_name" : "myfirstjob", "start_time" : "1484641003707", "end_time" : null,
"cluster_id" : "2b460e01-3351-4170-b0a7-57b9dd5ffef3", "group_id" : "669476bd-89d2-45aa-8f1a-872d16de377e",
"jar_path" : "s3a://jp-test1/program/hadoop-mapreduce-examples-2.4.1.jar", "input" : "s3a://jp-test1/input/",
"output" : "s3a://jp-test1/output/", "job_log" : "s3a://jp-test1/joblogs/", "job_type" : "1",
"file_action" : "",
"arguments" : "wordcount", "hql" : "",
"job_state" : "2", "job_final_status" : "1", "hive_script_path" : null,
"create_by" : "3f99e3319a8943ceb15c584f3325d064", "finished_step" : "0",
"job_main_id" : "", "job_step_id" : "",
"postpone_at" : "1484641003174", "step_name" : "",
"step_num" : "0", "task_num" : "0",
"update_by" : "3f99e3319a8943ceb15c584f3325d064", "spend_time" : null,
"step_seq" : "222", "progress" : "first progress"
} ] }
状态码
状态码 描述
200 查询作业exe对象列表成功。