HTTP任务（Serverless）

GET

使用GET请求方式需要在客户端中添加配置，然后在控制台中创建任务。

第一步：基本配置

1. 在客户端中添加配置GET方法配置。

   相关配置如下所示。关于客户端接入SchedulerX的详细步骤，请参见Spring Boot应用接入SchedulerX。

   @GET
   @Path("hi")
   @Produces(MediaType.APPLICATION_JSON)
   public RestResult hi(@QueryParam("user") String user) {
       TestVo vo = new TestVo();
       vo.setName(user);
       RestResult result = new RestResult();
       result.setCode(200);
       result.setData(vo);
       return result;
   }

2. 在控制台创建HTTP任务。

   HTTP任务GET方法的相关配置如下所示。关于创建调度任务，请参见创建调度任务。

   Serverless HTTP任务参数说明：

   配置项	说明
   任务名	任务名称。
   描述	任务描述。简洁地描述业务，便于后续搜索。
   应用ID	选择目标应用。
   任务类型	指任务所实现的类型，当前支持Java、Shell、Python、Go、http、xxljob和DataWorks等类型，其中Shell、Python和Go会弹出编辑框，在编辑框中编写任务脚本。本示例选择http。
   完整的URL	需要填写完整的URL，包括http://。
   请求方式	本示例选择GET。
   应答解析模式	选择应答解析模式。支持的模式如下： HTTP响应码 通过HTTP响应码应答，您需要设置标准的HTTP请求响应返回Code值。 自定义JSON 返回校验Key和返回校验Value。 服务端默认HTTP请求结果为JSON格式，根据填写的Key和Value校验结果是否成功。 { "code": 200, "data": "true", "message": "", "requestId": "446655068791923614103381232971", "success": true } 上方示例代码可以校验Key为Success，校验value:true或者校验Code是否为200。 自定义字符串 根据自定义的返回字符串内容是否完全匹配，判断任务是否执行成功。
   返回校验Key	仅支持返回值JSON格式，成功返回校验Key。
   返回校验Value	仅支持返回值JSON格式，成功返回校验Value。
   执行超时时间（秒）	serverless：基础版最大30秒，专业版最大120秒。agent：无限制。
   cookie	例如key1=val1;key2=val2。多个值用半角分号（;）隔开，最大长度为300字节。
   执行方式	serverless：由服务端发起请求，需要公网可访问的URL。 agent：需要提前部署schedulerxAgent，由客户端发起请求，可以配置内部URL。（仅支持1.8.2以上的客户端版本）。部署schedulerxAgent，请参见Agent接入（脚本或HTTP任务）。

第二步：定时配置

1. 在定时配置配置向导页，设置定时参数和高级配置参数，然后单击下一步。

   

   定时参数说明如下：

   配置名称	意义
   时间类型	none：无调度方式，一般通过工作流触发。 cron：Cron表达式。 api：通过API触发。 fixed_rate：固定频率。 second_delay：秒级固定延迟。 onetime：一次性任务。
   cron表达式（仅适用于cron时间类型）	填写Cron表达式。可以直接按照Cron语法填写，也可以使用工具生成并验证。
   固定频率（仅适用于fixed_rate时间类型）	填写固定频率，单位为秒，仅支持60秒以上。例如，200表示每200s调度一次。
   固定延迟（仅适用于second_delay时间类型）	填写固定延迟，单位为秒。范围为1秒~60秒。例如，5表示延迟5秒触发调度。

   当时间类型选择Cron后，可以进行高级配置。高级配置参数说明如下：

   配置名称	说明
   时间偏移	数据时间相对于调度时间的偏移，可以在调度时从上下文获取该值。
   时区	可以根据实际情况选择不同时区，包括一些常用国家或地区，也包括标准的GMT表达方式。

第三步：通知配置

HTTP任务支持错误报警，当出现上述超时以及返回值不符合预期的问题时，您可以在创建任务时设置报警条件，接收相应的报警信息。

1. 在通知配置配置向导页，设置报警参数及联系人，然后单击完成。

   

2. 任务创建成功后，在任务管理页面的操作列，单击运行一次。

   出现以下结果，表明任务执行成功。

POST

使用POST请求方式，需要在客户端中添加配置，然后在控制台中创建任务。

第一步：基本配置

1. 在客户端中添加POST配置。

   POST方法的配置信息如下所示。关于客户端接入SchedulerX的详细步骤，请参见Spring Boot应用接入SchedulerX。

   import com.alibaba.schedulerx.common.constants.CommonConstants;
   
   @POST
   @Path("createUser")
   @Produces(MediaType.APPLICATION_JSON)
   public RestResult createUser(@FormParam("userId") String userId, 
           @FormParam("userName") String userName) {
       TestVo vo = new TestVo();
       System.out.println("userId=" + userId + ", userName=" + userName);
       vo.setName(userName);
       RestResult result = new RestResult();
       result.setCode(200);
       result.setData(vo);
       return result;
   }

2. 在控制台创建HTTP任务。

   HTTP任务相关配置信息如下所示。关于创建调度任务，请参见创建调度任务。

   Serverless HTTP任务参数说明：

   配置项	描述
   完整的URL	需要填写完整的URL，包括http://。
   应答解析模式	选择应答解析模式。支持的模式如下： HTTP响应码 通过HTTP响应码应答，您需要设置标准的HTTP请求响应返回Code值。 自定义JSON 返回校验Key和返回校验Value。 服务端默认HTTP请求结果为JSON格式，根据填写的Key和Value校验结果是否成功。 { "code": 200, "data": "true", "message": "", "requestId": "446655068791923614103381232971", "success": true } 上面的示例代码可以校验Key为Success，校验value:true或者校验Code是否为200。 自定义字符串 按您自定义的返回字符串内容完全匹配判断任务是否执行成功。
   返回校验key和返回校验value	服务端默认HTTP请求结果为JSON格式，根据填写的Key和Value校验结果是否成功。 { "code": 200, "data": "true", "message": "", "requestId": "446655068791923614103381232971", "success": true } 上面的示例代码可以校验Key为Success，校验value:true或者校验Code是否为200。
   执行超时时间（秒）	最大30秒，超过会报错。
   post参数	POST表单参数，例如key1=val1;key2=val2。
   cookie	例如key1=val1;key2=val2。多个值用半角分号（;）隔开，最大长度为300字节。
   执行方式	serverless：由服务端发起请求，需要公网可访问的URL。 agent：需要提前部署schedulerxAgent，由客户端发起请求，可以配置内部URL。（仅支持1.8.2以上的客户端版本）。部署schedulerxAgent，请参见Agent接入（脚本或HTTP任务）。

第二步：定时配置

在定时配置配置向导页，设置定时参数和高级配置参数，然后单击下一步。

第三步：通知配置

HTTP任务支持错误报警，当出现上述超时以及返回值不符合预期的问题时，您可以在创建任务时设置报警条件，接收相应的报警信息。

1. 在通知配置配置向导页，设置报警参数及联系人，然后单击完成。

   

2. 任务创建成功后，在任务管理页面的操作列，单击运行一次。

   出现以下结果，表明任务执行成功。