更新时间:2022-02-22 GMT+08:00

查询作业执行对象列表

功能介绍

查询所有的作业执行对象列表。该接口兼容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

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

异常状态码请参见状态码