调用ExecuteJob触发一次任务。API类型任务触发需要调用方法,非API类型也可以调用。

说明 因为jobid+scheduleTime是唯一索引,所以同一个任务连续调用ExecuteJob接口的时候,每次要sleep一秒,不然有可能会失败。

请求参数

名称 类型 是否必选 示例值 描述
Action String ExecuteJob

系统规定参数。取值为ExecuteJob

GroupId String testSchedulerx.defaultGroup

应用ID,在控制台的应用管理页面中获取。

InstanceParameters String test

本次触发携带参数,可以是任意字符串,processor代码通过context.getInstanceParameters()获取,区别于创建任务自定义参数 。

JobId Long 92583

任务ID,在控制台的任务管理页面中获取。

Namespace String adcfc35d-e2fe-4fe9-bbaa-20e90ffc****

命名空间ID,在控制台的命名空间页面中获取。

RegionId String cn-hangzhou

地域ID。

NamespaceSource String schedulerx

特殊第三方才需要填写。

返回数据

名称 类型 示例值 描述
Code Integer 200

返回码

Data Struct

如果成功,会返回任务实例ID。

JobInstanceId Long 11111111

任务实例ID

Message String groupid not exist groupId: testSchedulerx.defaultGroup namespace: adcfc35d-e2fe-4fe9-bbaa-20e90ffc****

错误消息,仅出错时返回错误信息。

RequestId String 4F68ABED-AC31-4412-9297-D9A8F0401108

请求唯一ID

Success Boolean true

触发任务是否成功。取值如下:

  • true:触发任务成功。
  • false:触发任务失败。

示例

请求示例

http(s)://[Endpoint]/?Action=ExecuteJob
&GroupId=testSchedulerx.defaultGroup
&InstanceParameters=test
&JobId=92583
&Namespace=adcfc35d-e2fe-4fe9-bbaa-20e90ffc****
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式

<ExecuteJobResponse>
<RequestId>4F68ABED-AC31-4412-9297-D9A8F0401108</RequestId>
<Message>groupid not exist groupId: testSchedulerx.defaultGroup namespace: adcfc35d-e2fe-4fe9-bbaa-20e90ffc****</Message>
<Data>
    <JobInstanceId>11111111</JobInstanceId>
</Data>
<Code>200</Code>
<Success>true</Success>

JSON 格式

{
    "RequestId": "4F68ABED-AC31-4412-9297-D9A8F0401108",
    "Message": "groupid not exist groupId: testSchedulerx.defaultGroup namespace: adcfc35d-e2fe-4fe9-bbaa-20e90ffc****",
    "Data": {
        "JobInstanceId": 11111111
    },
    "Code": 200,
    "Success": true
}