更新时间:2023-12-14 GMT+08:00

查询批处理作业列表

功能介绍

该API用于查询Project下某队列批处理作业的列表。

URI

  • URI格式:

    GET /v2.0/{project_id}/batches

  • 参数说明
    表1 URI参数

    参数名称

    是否必选

    参数类型

    说明

    project_id

    String

    项目编号,用于资源隔离。获取方式请参考获取项目ID

    表2 query参数说明

    参数名称

    是否必选

    参数类型

    说明

    job_name

    String

    批处理作业的名称。

    job-id

    String

    根据作业ID查询批作业。

    cluster_name

    String

    DLI队列名称,不填写则获取当前Project下所有批处理作业(不推荐使用)。

    queue_name

    String

    DLI队列名称,根据队列查询批作业(推荐使用)。

    from

    Integer

    起始批处理作业的索引号,默认从0开始。

    size

    Integer

    查询批处理作业的数量。

    state

    String

    根据作业状态查询批作业。

    owner

    String

    提交作业的用户。

请求消息

无请求参数。

响应消息

表3 响应参数说明

参数名称

是否必选

参数类型

说明

from

Integer

起始批处理作业的索引号。

total

Integer

返回批处理作业的总数。

sessions

Array of objects

批处理作业信息。详细说明请参见表4

create_time

Long

批处理作业的创建时间。

表4 sessions参数

参数名称

是否必选

参数类型

说明

duration

Long

作业运行时长,单位毫秒。

id

String

批处理作业的id。

state

String

批处理作业的状态。

appId

String

批处理作业的后台app id。

log

Array of Strings

显示当前批处理作业的最后10条记录。

sc_type

String

计算资源类型。用户自定义时返回CUSTOMIZED。

cluster_name

String

批处理作业所在队列。

create_time

Long

批处理作业的创建时间。是单位为“毫秒”的时间戳。

name

String

批处理作业名称。

owner

String

批处理作业所属用户。

proxyUser

String

批处理作业所属代理用户(资源租户)。

kind

String

批处理作业类型,只支持spark类型参数。

queue

String

批处理作业所在队列。

image

String

自定义镜像。格式为:组织名/镜像名:镜像版本。

当用户设置“feature”“custom”时,该参数生效。用户可通过与“feature”参数配合使用,指定作业运行使用自定义的Spark镜像。

req_body

String

请求参数详情。

update_time

Long

批处理作业的更新时间。是单位为“毫秒”的时间戳。

请求示例

响应示例

{
    "from": 0,
    "total": 1,
    "sessions": [
        {
            "id": "178fa687-2e8a-41ed-a439-b00de60bb176",
            "state": "dead",
            "appId": null,
            "log": [
             "stdout: ",
             "stderr: ",
             "YARN Diagnostics: "
           ],
           "sc_type": "A",
           "cluster_name": "test",
           "create_time": 1531906043036
        }
    ]
}

状态码

状态码如表5所示。

表5 状态码

状态码

描述

200

查询成功。

400

请求错误。

500

内部服务器错误。

错误码

调用接口出错后,将不会返回上述结果,而是返回错误码和错误信息,更多介绍请参见错误码