本文介紹如何在任務管理頁面建立並管理XXL-JOB。
建立調度任務
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理，單擊建立任務。在基本配置嚮導頁，配置調度任務的相關資訊，然後單擊下一步。
配置項分類
配置項
描述
預設值
基本配置
任務名稱
任務的名稱，同一個應用下需保持唯一。
無
任務描述
任務的描述。
無
關聯應用
該應用屬於哪個應用。
無
任務類型
支援BEAN、Dify工作流程、GLUE(Java)、GLUE(Shell)、GLUE(Python)、GLUE(PHP)、GLUE(NodeJs)、GLUE(PowerShell)任務類型。
BEAN
JobHandler名稱
對應執行器端被
@Xxljob註解聲明的jobHandler。無
路由策略
輪詢、隨機、第一個、最後一個、最不經常使用、最近最久未使用、一致性雜湊、分區廣播。
輪詢
堵塞處理策略
用戶端層級的限流策略：單機串列、丟棄後續調度、覆蓋之前調度。
單機串列
優先順序
低、中、高、非常高。
中
輸入
任務的參數，最大2000位元組。
無
進階配置
任務失敗重試次數
任務失敗自動重試的最大次數。
0
任務失敗稍候再試
任務每次失敗重試的間隔。
30秒
任務並發數
同一個任務同一時間允許啟動並執行最大執行個體個數，1表示不允許重複執行。如果超過並發數，會跳過當前調度。
1
子任務ID
輸入子任務ID。
說明任務執行成功後，觸發子任務執行。可以輸入多個子任務ID，並以逗號分隔。
無
在定時配置嚮導頁，設定定時參數和進階配置參數，然後單擊下一步。
配置項
描述
預設值
時間類型
none、cron、api、fixed_rate、fixed_delay、one_time。
cron
時間運算式
不同的時間類型有不同的運算式：
none：無運算式。
cron：Cron運算式，可以精確到秒。
fixed_rate：固定執行頻率，單位秒，即每隔N秒調度一次。
fixed_delay：固定延時，單位秒，即上次執行完成後隔N秒再調度下一次。
api：通過openapi調度。
one_time：一次性任務，跑完任務自動銷毀，格式"yyyy-MM-dd HH:mm:ss"，比如"2024-10-10 12:12:20"。
無
資料時間位移
資料時間相對於調度時間的位移，可以在調度時從上下文擷取該值。
無
時區
可以按照固定時區調度，主要適用於cron運算式。
當前地區時區
日曆
可以匯入自訂日曆，按照日曆調度，比如只想在工作日執行。
每天調度
生效時間
指定任務開始生效時間。
立即生效
在通知配置設定精靈頁，設定警示參數及連絡人，然後單擊完成。
配置項
描述
預設值
逾時警示
任務執行逾時是否發送警示。
開啟
逾時時間
任務執行逾時的時間，按照業務自行設定。
7200秒
逾時終止
任務執行超過指定時間是否自動停止，防止把下一次調度卡住。
關閉
成功通知
任務執行成功是否通知給連絡人，一般天層級比較重要的任務設定。
關閉
失敗警示
任務執行失敗是否警示。
開啟
連續失敗次數
任務連續失敗指定次數才警示。
1
無可用機器警示
任務調度的時候沒有可用執行器是否警示。
開啟
通知方式
簡訊、webhook、郵件、電話。
無
通知對象
整合CloudMonitor連絡人，需要去CloudMonitor配置連絡人並啟用連絡方式。
無
如果選用webhook警示（DingTalk/企業微信/飛書），需要通過公網外發，所以需要您的VPC網路綁定公網NAT Gateway，如下圖：
編輯調度任務
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
單擊目標任務操作列的編輯。在編輯任務面板中修改基本配置、定時配置和通知配置，然後單擊完成。
刪除調度任務
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
單擊目標任務下的刪除。在刪除對話方塊中單擊刪除。
匯入任務
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
單擊匯入任務，在匯入任務對話方塊中，選擇相同任務覆蓋或者跳過，是否自動建立App，選擇檔案上傳後，單擊確定。
匯出任務
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
單擊匯出任務，在匯出任務對話方塊中，選擇匯出任務的應用程式名稱，單擊確定。
批量啟用任務
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
勾選需要批量啟用的任務，單擊批量啟用任務。在批量啟用任務對話方塊中，單擊確定。
批量禁用任務
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
勾選需要批量禁用的任務，單擊批量禁用任務。在批量禁用任務對話方塊中，單擊確定。
大量刪除任務
任務刪除後將不可恢複。
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
勾選需要大量刪除的任務，單擊大量刪除任務。在大量刪除任務對話方塊中，單擊確定。
運行一次調度任務
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
單擊目標任務操作列下的運行一次。在手動執行任務對話方塊中，指定執行機器和任務參數，單擊確定。
複製調度任務
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
單擊目標任務下的複製。在複製任務面板中，填寫基本配置、定時配置和通知配置，然後單擊完成。
禁用調度任務
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
單擊目標任務下的禁用。在禁用對話方塊中，單擊禁用。
查看調度記錄
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
單擊目標任務下的調度記錄。查看任務調度執行記錄。
重刷任務
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
單擊目標任務下的重刷任務。在重刷任務面板中，選擇起止日期和資料時間，然後單擊確定。
指定機器
登入MSE XXL-JOB控制台，並在頂部功能表列選擇地區。
在左側導覽列，選擇。
單擊進入目標執行個體，在左側導覽列的任務管理。
單擊目標任務下的指定機器，在指定機器面板中，選擇指定類型下拉框為地址或者標籤後，指定機器，單擊確定。
說明機器轉移：開啟機器轉移開關，當指定機器全部下線時任務可以調度到非指定機器。
Cron運算式
Cron的運算式為：秒分時 日月周[年]。
為了協助您理解，下面介紹一些常用的Cron運算式樣本。
Contab運算式 | 說明 |
0 */1 * * * ? | 每隔1分鐘觸發一次。 |
0 0 5-15 * * ? | 每天5:00~15:00整點觸發。 |
0 0/3 * * * ? | 每隔3分鐘觸發一次。 |
0 0-5 14 * * ? | 每天14:00~14:05期間每隔1分鐘觸發一次。 |
0 0/5 14 * * ? | 每天14:00~14:55期間每隔5分鐘觸發一次。 |
0 0/5 14,18 * * ? | 每天14:00~14:55和18:00~18:55兩個時間段內每5分鐘觸發一次。 |
0 0/30 9-17 * * ? | 每天9:00~17:00內每半小時觸發一次。 |
0 0 10,14,16 * * ? | 每天10:00、14:00和16:00觸發。 |
0 0 12 ? * WED | 每周三12:00觸發。 |
0 0 17 ? * TUES,THUR,SAT | 每周二、周四、周六17:00觸發。 |
0 10,44 14 ? 3 WED | 每年3月的每周三的14:10和14:44觸發。 |
0 15 10 ? * MON-FRI | 周一至周五的上午10:15觸發。 |
0 0 23 L * ? | 每月最後一天23:00觸發。 |
0 15 10 L * ? | 每月最後一天10:15觸發。 |
0 15 10 ? * 6L | 每月最後一個周五10:15觸發。 |
0 15 10 * * ? 2005 | 2005年的每天10:15觸發。 |
0 15 10 ? * 6L 2002-2005 | 2002年~2005年的每月的最後一個周五上午10:15觸發。 |
0 15 10 ? * 6#3 | 每月的第三個周五10:15觸發。 |