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. 任務創建成功后，在任務管理頁面的操作列，單擊運行一次。

   出現以下結果，表明任務執行成功。