調用UpdateTaskFlowSchedule介面,更新任務流調度配置。
介面說明
該介面用於更新編輯態任務流的調度設定。可配置定時調度、周期調度、事件調度;其中定時調度可配置調度一次或周期調度,事件調度可配置的訂閱包括任務流和任務流節點。
配置更新後,將任務流重新發布並部署,新的任務流執行個體將按照配置的調度設定進行調度。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
dms:UpdateTaskFlowSchedule |
update |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| Tid |
integer |
否 |
租戶 ID。 說明
滑鼠移動到介面右上方的頭像處,查看租戶 ID。具體操作,請參見查看租戶資訊。 |
3*** |
| DagId |
integer |
是 |
任務流 ID,任務流的唯一標識。 |
7*** |
| ScheduleSwitch |
boolean |
是 |
是否開啟調度。
|
false |
| CronBeginDate |
string |
否 |
此時間點之前任務流不進行調度。 |
CronBeginDate_test |
| CronEndDate |
string |
否 |
定時調度結束時間,此時間點之後任務流不進行調度。 |
CronEndDate_test |
| ScheduleParam |
string |
是 |
事件調度配置,JSON 字串格式。 |
ScheduleParam_test |
| CronStr |
string |
否 |
定時調度 Cron。 |
CronStr_test |
| TriggerType |
string |
是 |
觸發類型,取值如下:
|
Event |
| CronType |
string |
否 |
調度周期類型。取值如下:
|
HOUR |
| TimeZoneId |
string |
否 |
時區設定,預設為東八區(Asia/Shanghai)。 |
Asia/Shanghai |
調度配置相關參數說明
配置定時調度:可配置周期調度或調度一次。
必填參數如下:
ScheduleSwitch:True
TriggerType:Cron
CronBeginDate
CronEndDate
CronStr
CronType
ScheduleParam:分為按天、周、月、調度一次。
樣本如下:
按“天”調度:
{
"triggerType":"0",
"dateTime":"00:00"
}
按“周”調度:周日為 1,周一為 2,…,周六為 7。
{
"triggerType":"0",
"dateWeek":[
"1",
"5"
],
"weekTime":"00:00"
}
按“月”調度:
{
"triggerType":"0",
"dateMonth":"1",
"MonthTime":"00:00"
}
調度一次:
{
"triggerType":"1",
"specificTime":"2022-09-02 00:00"
}
參數說明
CronStr:任務流實際調度以 CronStr 指定為準。
CronBeginDate 和 CronEndDate:周期調度時,CronBeginDate、CronEndDate 及 CronStr 共同定義了任務流調度。若 CronStr 指定的時間點在 CronBeginDate、CronEndDate 的時間範圍內,任務將被觸發。
CronType:驗證使用,按照 CronStr 定義的周期填寫。
ScheduleParam:需按照 CronStr 指定的調度填寫。
配置事件調度(跨任務流自動觸發)
必填參數如下:
ScheduleSwitch:True
TriggerType: Event
ScheduleParam
樣本如下:
{
"triggerType":"2" // 事件調度時置為 2
"deps":[ // 任務流、節點訂閱配置
{
"eventType":1, // 訂閱類型: 0 為任務流; 1 為任務節點
"lisDagId":12345, // 訂閱節點所在的任務流
"lisNodeId":2134 // 訂閱節點的 Id
},
{
"eventType":0,
"lisDagId":12343 // 訂閱任務流的 Id
},
{
"eventType":0,
"lisDagId":23456
}
],
"maxWait":21600 // 在所有以上訂閱運行成功前,最大等待時間
}
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回參數詳情如下。 |
||
| RequestId |
string |
請求 ID,用於定位日誌,排查問題。 |
7BF38A13-C181-5B5E-97F1-8643F8A10093 |
| ErrorCode |
string |
錯誤碼。 |
InvalidParameterValid |
| ErrorMessage |
string |
調用失敗時,返回的錯誤資訊。 |
InvalidParameterValid |
| Success |
boolean |
請求是否成功,傳回值如下:
|
true |
樣本
正常返回樣本
JSON格式
{
"RequestId": "7BF38A13-C181-5B5E-97F1-8643F8A10093",
"ErrorCode": "InvalidParameterValid",
"ErrorMessage": "InvalidParameterValid",
"Success": true
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。