更新时间:2024-11-22 GMT+08:00

启动作业

功能介绍

启动作业接口。

调用方法

请参见如何调用API

URI

PUT /v1.1/{project_id}/clusters/{cluster_id}/cdm/job/{job_name}/start

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参见项目ID和账号ID

cluster_id

String

集群ID。

job_name

String

作业名称。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

variables

Object

启动作业,配置变量参数,作业配置无变量时,为空对象。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

submissions

Array of StartJobSubmission objects

作业运行信息,请参见submission参数说明。

表5 StartJobSubmission

参数

参数类型

描述

isIncrementing

Boolean

作业是否为增量迁移。

delete_rows

Integer

删除数据行数。

update_rows

Integer

更新数据行数。

write_rows

Integer

写入数据行数。

submission-id

Integer

作业提交id。

job-name

String

作业名称。

creation-user

String

创建用户。

creation-date

Long

创建时间,单位:毫秒。

execute-date

Long

执行时间。

progress

Float

作业进度,失败时为“-1”,其它情况为0~100。

status

String

作业状态:

  • BOOTING:启动中。

  • FAILURE_ON_SUBMIT:提交失败。

  • RUNNING:运行中。

  • SUCCEEDED:成功。

  • FAILED:失败。

  • UNKNOWN:未知。

  • NEVER_EXECUTED:未被执行。

isStopingIncrement

String

是否停止增量迁移。

is-execute-auto

Boolean

是否定时执行作业。

last-update-date

Long

作业最后更新时间。

last-udpate-user

String

最后更新作业状态的用户。

isDeleteJob

Boolean

作业执行完成后是否删除。

请求示例

启动作业,参数为空。

PUT /v1.1/1551c7f6c808414d8e9f3c514a170f2e/clusters/6ec9a0a4-76be-4262-8697-e7af1fac7920/cdm/job/jdbc2hive/start

{
  "variables" : { }
}

响应示例

状态码: 200

OK。

{
  "submissions" : [ {
    "job-name" : "jdbc2hive",
    "creation-user" : "cdm",
    "creation-date" : "1536905778725",
    "progress" : 1,
    "status" : "BOOTING"
  } ]
}

状态码

状态码

描述

200

OK。

错误码

请参见错误码