更新时间:2022-12-07 GMT+08:00

批量运行作业

功能介绍

该API用于触发批量运行作业。

URI

  • URI格式

    POST /v1.0/{project_id}/streaming/jobs/run

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

    参数名称

    是否必选

    参数类型

    说明

    project_id

    String

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

请求消息

表2 请求参数说明

参数名称

是否必选

参数类型

说明

job_ids

Array of Long

批量作业ID。 作业ID可以通过创建作业接口或者查询作业接口获取。

resume_savepoint

Boolean

是否将作业从最近创建的保存点恢复。

  • “resume_savepoint”“true”时,表示作业从最近创建的保存点恢复。
  • “resume_savepoint”“false”时,表示不恢复正常启动。

默认为“false”

响应消息

表3 响应参数说明

参数名称

是否必选

参数类型

说明

数组元素

Array of Objects

返回的响应消息组。具体请参考表4

表4 数组元素参数说明

参数名称

是否必选

参数类型

说明

is_success

Boolean

执行请求是否成功。“true”表示请求执行成功。

message

String

消息内容。

请求示例

{
    "job_ids": [131,130,138,137],
    "resume_savepoint": true
}

响应示例

[
    {
        "is_success": "true",
        "message": "作业提交请求下发成功"
    },
    {
        "is_success": "true",
        "message": "作业提交请求下发成功"
    },
    {
        "is_success": "true",
        "message": "作业提交请求下发成功"
    },
    {
        "is_success": "true",
        "message": "作业提交请求下发成功"
    }
]

状态码

状态码如表5所示。

表5 状态码

状态码

描述

200

批量运行作业成功。

400

输入参数无效。

错误码

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