文档首页/ MapReduce服务 MRS/ API参考(巴黎区域)/ API V1.1/ 作业执行对象接口/ 查询作业执行对象列表
更新时间：2022-02-22 GMT+08:00
查看PDF
分享

查询作业执行对象列表

功能介绍

查询所有的作业执行对象列表。该接口兼容Sahara。

URI

  • URI格式

    GET /v1.1/{project_id}/job-executions

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

    名称

    是否必选

    说明

    project_id

    是

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

    limit

    否

    返回数据中最大对象个数。

    取值范围：1～1073741822

    marker

    否

    作业执行ID。

    查询作业执行列表，选择一个作业执行ID作为Marker，这个ID为列表中最后一个元素的ID，该元素不会出现在返回数据中。

    sort_by

    否

    排序字段，-号表示降序排列。例如：

    • sort_by=name表示按name升序排序
    • sort_by=-name表示按name降序排序

请求消息

请求参数

无。

响应消息

表2 响应参数说明

名称

参数类型

说明

markers

Object

markers对象。参数说明，请参见表3。

job_executions

Array

作业执行列表。参数说明，请参见表4。
表3 markers参数说明

名称

参数类型

说明

prev

String

上一页的marker。

next

String

下一页的marker。
表4 job_executions参数说明

名称

参数类型

说明

job_configs

Object

键值对集合，用于保存作业运行配置。参数说明，请参见表5。

is_protected

Bool

作业执行对象是否受保护。

  • true
  • false

当前版本不支持该功能。

input_id

String

作业执行对象输入数据源ID。

job_id

String

作业ID。

cluster_id

String

集群ID。

created_at

String

作业执行对象创建时间。

end_time

String

作业结束时间。

output_id

String

作业执行对象输出数据源ID。

is_public

Bool

作业执行对象是否公开。

  • true
  • false

当前版本不支持该功能。

updated_at

String

作业执行对象更新时间。

return_code

String

作业执行后的响应码。

data_source_urls

Object

作业执行对象的数据源URL。

tenant_id

String

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

start_time

String

作业开始时间。

Id

String

作业执行对象ID。

engine_job_id

String

oozie工作流ID。

oozie_job_id

String

集群中oozie返回的工作流ID。

info

String

键值对集合，包含oozie返回的作业运行信息。
表5 job_configs参数说明

名称

参数类型

说明

configs

Object

作业配置的键值对集合。

args

Array

参数列表。

params

Object

运行作业的键值对集合。

示例

  • 请求示例 
    GET /v1.1/{project_id}/job-executions?limit=2&sort_by=id&marker=839244be-c471-469b-80c0-6f63e376bcbc
  • 响应示例 
    {
    "markers": {
        "prev": "821c8924-5249-4dd8-8069-b8d425f3f54a",
        "next": null
    },
    "job_executions": [
        {
            "created_at": "2017-06-22T06:24:57",
            "updated_at": "2017-06-22T06:24:59",
            "id": "84900772-8807-4ddc-9484-f719fa43711f",
            "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
            "job_id": "",
            "start_time": "2017-06-22T06:24:49",
            "end_time": "2017-06-22T06:25:02",
            "cluster_id": "33dff020-7f96-4270-9c3a-88b99627f6e2",
            "oozie_job_id": null,
            "return_code": null,
            "input_id": null,
            "output_id": null,
            "is_protected": false,
            "is_public": null,
            "engine_job_id": null,
            "job_configs": null,
            "data_source_urls": null,
            "info": null
        },
        {
            "created_at": "2017-06-22T06:23:51",
            "updated_at": "2017-06-22T06:23:51",
            "id": "852042ea-a32c-424b-aacf-df2e6d6642b5",
            "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
            "job_id": "",
            "start_time": "2017-06-22T06:23:51",
            "end_time": null,
            "cluster_id": "33dff020-7f96-4270-9c3a-88b99627f6e2",
            "oozie_job_id": null,
            "return_code": null,
            "input_id": null,
            "output_id": null,
            "is_protected": false,
            "is_public": null,
            "engine_job_id": null,
            "job_configs": null,
            "data_source_urls": null,
            "info": null
        }
    ]
}

状态码

状态码如表6所示。

表6 状态码

状态码

描述

200

查询作业执行对象列表成功。

异常状态码请参见状态码。