用途
在列出作业时,Data Mover 提供以下筛选器变量:
- 满足指定条件(包括开始时间、结束时间和状态)的作业
- 已运行且满足指定条件(包括开始时间、结束时间、状态和优先级)的作业
- 当前正在运行且满足指定条件(包括开始时间、状态和优先级)的作业
- 具有冻结步骤的作业
项 | 说明 | ||
---|---|---|---|
URL | /datamover/jobs /datamover/executedJobs /datamover/executingJobs /datamover/jobs?freezeJobStepsOnly=value |
||
方法 | GET |
请求参数 (/datamover/jobs)
此变量返回满足特定条件的作业名称的列表,包括开始时间、结束时间以及状态。如果未提供任何参数,则返回新作业和已完成作业的列表。
- startTimeAfter
- 说明︰开始时间晚于指定时间的作业
- endTimeBefore
- 说明︰完成时间早于指定时间的作业。
- endTimeAfter
- 说明:完成时间晚于指定时间的作业。
- freezeJobStepsOnly
- 说明:仅列出 freezeJobStepsOnly 设置为 true 的作业
- jobName
- 说明︰作业名称
- latestJobsOnly
- 说明:列出守护程序中运行的最新作业。
- status
- 说明︰最后一次启动状态与以下其中之一相匹配的作业:
- NEW:所有新作业
- INITIALIZING:所有正在初始化的作业
- RUNNING:所有正在运行的作业
- BLOCKED:所有已阻止的作业
- COMPLETED:所有已成功完成的作业
- FAILED:所有失败的作业
- RESTARTING:所有正在重新启动的作业
- CANCELLED:所有用户取消的作业
- QUEUED:所有已排队的作业
响应参数 (/datamover/jobs)
- jobExecutionName
- 说明︰已启动作业名称
- jobName
- 说明︰作业名称(最大字符数︰237)
- startTime
- 说明︰如果作业已启动,则为开始时间;如果未启动,则为 null
- endTime
- 说明︰如果作业已启动,则为结束时间;如果未启动,则为 null
- status
- 说明︰作业的状态(最大字符数︰12),其中可能的值已在“请求参数”部分指定
- Priority
- 说明︰如果作业已启动,则为作业优先级(最大字符数︰11),其中值为以下项之一︰
- UNSPECIFIED
- LOW
- MEDIUM
- HIGH
响应示例 (/datamover/jobs)
此示例显示一个开始时间晚于指定时间的作业阵列;如果未找到任何作业,则返回空阵列。
[ { "jobName" : "runningJob" , "startTime" : "2015-07-16T17:14:13Z", "endTime" : null , "status" : "RUNNING" , "priority" : "MEDIUM" , "links" : [ { "rel" : "status" , "href" : "http://server/datamover/executingJobs/runningJob-1417744247669" }, { "rel" : "past_executions" , "href" : "http://server/datamover/executedJobs?jobName=runningJob&startTimeAfter=<value>" } { "rel" : "job_steps" , "href" : "http://server/datamover/jobs/runningJob/steps" } ] }, { "jobName" : "successfulJob" , "startTime" : "2015-07-16T17:14:13Z", "endTime" : "2015-07-16T19:14:13Z", "status" : "COMPLETED" , "priority" : "MEDIUM" , "links" : [ { "rel" : "status" , "href" : "http://server/datamover/executedJobs/successfulJob-20141204175020" }, { "rel" : "past_executions" , "href" : "http://server/datamover/executedJobs?jobName=successfulJob &startTimeAfter=<value> " } { "rel" : "job_steps" , "href" : "http://server/datamover/jobs/successfulJob/steps" } ] }, { "jobName" : "failedJob" , "startTime" : 1417744247669, "endTime" : 1417744323437, "status" : "FAILED" , "priority" : "MEDIUM" , "links" : [ { "rel" : "status" , "href" : "http://server/datamover/executedJobs/failedJob-20141204175020" }, { "rel" : "past_executions" , "href" : "http://server/datamover/executedJobs?jobName=failedJob &startTimeAfter=<value> " } { "rel" : "job_steps" , "href" : "http://server/datamover/jobs/failedJob/steps" } ] } ]
请求参数 (/datamover/executedJobs)
此变量返回满足指定条件的作业名称的列表,包括新作业或正在运行的作业。
- startTimeAfter
- 说明︰开始时间晚于指定时间的作业
- endTimeBefore
- 说明:完成时间早于指定时间的作业
- endTimeAfter
- 说明︰完成时间晚于指定时间的作业
- status
- 说明︰最后一次运行状态与以下其中之一相匹配的作业:
- COMPLETED:所有已成功完成的作业
- FAILED:所有失败的作业
- CANCELLED:所有用户取消的作业
- jobName
- 说明︰映射到指定名称的已启动作业
响应参数 (/datamover/executedJobs)
- endTime
- 说明︰如果作业已启动,则为结束时间;如果未启动,则为 null
- estimatedJobSize
- 描述:估计的最高作业大小
- jobExecutionName
- 说明︰已启动作业名称
- jobName
- 说明︰作业名称(最大字符数︰237)
- startTime
- 说明︰如果作业已启动,则为开始时间;如果未启动,则为 null
- status
- 说明︰作业状态(最大字符数:11),其中可能的值已在“请求参数”部分列出
- Priority
- 说明︰作业的优先级(如果已启动)(最大字符数︰11),其中值为以下项之一︰
- UNSPECIFIED
- LOW
- MEDIUM
- HIGH
- submitTime
- 说明:提交作业的时间
RESTful API 示例 (/datamover/executedJobs)
此示例显示一个已启动作业;如果未找到任何作业,则返回空阵列。
[ { "jobExecutionName" : "successfulJob-20141204175020" , "jobName" : "successfulJob" , "startTime" :"2015-07-01T17:38:12Z", "endTime" : "2015-07-01T19:38:12Z", "status" : "COMPLETED" , "priority" : "MEDIUM" , "links" : [ { "rel" : "status" , "href" : "http://server/datamover/executedJobs/successfulJob-20141204175020" } { "rel" : "job_steps" , "href" : "http://server/datamover/jobs/successfulJob/steps" } ] }, { "jobExecutionName" : "successfulJob-20141204175111" , "jobName" : "successfulJob" , "startTime" : "2015-07-02T17:38:12Z", "endTime" : "2015-07-02T19:38:12Z", "status" : "COMPLETED" , "priority" : "MEDIUM" , "links" : [ { "rel" : "status" , "href" : "http://server/datamover/executedJobs/successfulJob-20141204175111" } { "rel" : "job_steps" , "href" : "http://server/datamover/jobs/successfulJob/steps" } ] }, { "jobExecutionName" : "failedJob-20141204175020" , "jobName" : "failedJob" , "startTime" : "2015-07-03T17:38:12Z", "endTime" : "2015-07-03T19:38:12Z", "status" : "FAILED" , "priority" : "MEDIUM" , "links" : [ { "rel" : "status" , "href" : "http://server/datamover/executedJobs/failedJob-20141204175020" } { "rel" : "job_steps" , "href" : "http://server/datamover/jobs/failedJob/steps" } ] } ]
请求参数 (/datamover/executingJobs)
此变量返回 Data Mover 守护程序上目前正在运行的及开始时间晚于指定时间的所有作业,其中值为以下项之一︰
- INITIALIZING
- RUNNING
- BLOCKED
- RESTARTING
- QUEUED
您可以提供以下可选参数︰
- startTimeAfter
- 说明︰开始时间晚于指定时间的作业
- status
- 说明︰最后一次运行状态与以下其中之一相匹配的作业:
- COMPLETED:所有已成功完成的作业
- FAILED:所有失败的作业
- CANCELLED:所有用户取消的作业
响应参数 (/datamover/executingJobs)
- jobExecutionName
- 说明︰已启动作业名称
- jobName
- 说明︰作业名称(最大字符数︰237)
- startTime
- 说明︰如果作业已启动,则为开始时间;如果未启动,则为 null
- status
- 说明︰作业状态(最大字符数:11),其中可能的值已在“请求参数”列表中指定
- Priority
- 说明︰作业的优先级(如果已启动)(最大字符数︰11),其中值为以下项之一︰
- UNSPECIFIED
- LOW
- MEDIUM
- HIGH
RESTful API 示例 (/datamover/executingJobs)
此示例显示一个已启动作业;如果未找到任何作业,则返回空阵列。
[ { "jobExecutionName" : "runningJob-1417744247669" , "jobName" : "runningJob" , "startTime" :"2015-07-16T17:14:13Z", "status" : "RUNNING" , "priority" : "MEDIUM" , "links" : [ { "rel" : "status" , "href" : "http://server/datamover/runningJobs/runningJob-1417744247669" }, { "rel" : "history" , "href" : "http://server/datamover/executedJobs?jobName=runningJob&startTimeAfter=<value>" } { "rel" : "job_steps" , "href" : "http://server/datamover/jobs/runningJob/steps" } ] } ]
请求参数 (/datamover/jobs?freezeJobStepsOnly=value)
- freezeJobStepsOnly
- 说明:将冻结作业步骤设置为 true 的作业
响应参数 (/datamover/jobs?freezeJobStepsOnly=value)
- jobExecutionName
- 说明︰已启动作业名称
- jobName
- 说明︰作业名称(最大字符数︰237)
- links
- 说明:指向作业状态、过去的作业执行情况和作业步骤的链接列表
- Priority
- 说明︰作业的优先级(如果已启动)(最大字符数︰11),其中值为以下项之一︰
- UNSPECIFIED
- LOW
- MEDIUM
- HIGH
- startTime
- 说明:作业开始时间
- status
- 说明︰作业的状态(最大字符数︰12),其中可能值已在“请求参数”说明中指定