更新时间:2026-01-30 GMT+08:00

查询作业状态

功能介绍

查询作业状态接口。

调用方法

请参见如何调用API

URI

GET /v1.1/{project_id}/clusters/{cluster_id}/cdm/job/{job_name}/status

表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的值)。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

submissions

Array of Submission objects

作业运行信息,详见submissions参数说明。

表4 Submission

参数

参数类型

描述

isIncrementing

Boolean

作业是否为增量迁移。

job-name

String

作业名称。

counters

counters object

作业运行结果统计,当“status”为“SUCCEEDED”时才有此字段,请参见counters数据结构参数说明。

isStopingIncrement

String

是否停止增量迁移。

is-execute-auto

Boolean

是否定时执行作业。

last-update-date

Long

作业最后更新时间。

last-update-user

String

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

isDeleteJob

Boolean

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

creation-user

String

创建用户。

creation-date

Long

创建时间。

external-id

String

作业ID。

progress

Float

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

submission-id

Integer

作业提交id。

delete_rows

Integer

删除数据行数。

update_rows

Integer

更新数据行数。

write_rows

Integer

写入数据行数。

execute-date

Long

执行时间。

status

String

作业状态:

  • BOOTING:启动中。

  • FAILURE_ON_SUBMIT:提交失败。

  • RUNNING:运行中。

  • SUCCEEDED:成功。

  • FAILED:失败。

  • UNKNOWN:未知。

  • NEVER_EXECUTED:未被执行。

error-details

String

错误详情,当“status”为“FAILED”时才有此字段。

error-summary

String

错误总结,当“status”为“FAILED”时才有此字段。

表5 counters

参数

参数类型

描述

org.apache.sqoop.submission.counter.SqoopCounters

counter object

作业运行结果统计,请参见统计结果参数说明。

表6 counter

参数

参数类型

描述

BYTES_WRITTEN

Long

写入的字节数。

TOTAL_FILES

Integer

总文件数。

ROWS_READ

Long

读取的行数。

BYTES_READ

Long

读取的字节数。

ROWS_WRITTEN

Long

写入的行数。

FILES_WRITTEN

Integer

写入的文件数。

FILES_READ

Integer

读取的文件数。

TOTAL_SIZE

Long

总字节数。

FILES_SKIPPED

Integer

跳过的文件数。

ROWS_WRITTEN_SKIPPED

Long

跳过的行数。

请求示例

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

响应示例

状态码:200

OK。

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

状态码

状态码

描述

200

OK。

错误码

请参见错误码