更新工作流定时调度信息
功能介绍
更新工作流定时调度信息接口用于修改指定工作流的定时调度任务的配置。
该接口适用于以下场景：当用户需要调整某个工作流的定时调度任务，例如更改备注内容、是否生效等信息时，可以通过此接口更新定时调度任务的配置。使用该接口的前提条件是用户已登录并具有对目标工作流定时调度的管理权限，且目标工作流及其定时调度任务已存在。更新操作完成后，定时调度任务将按照新的配置执行。若工作流或定时调度任务不存在或用户无权限操作，接口将返回相应的错误信息。
接口约束
无
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PUT /v2/{project_id}/workflows/{workflow_id}/schedules/{schedule_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释：用户项目ID。获取方法请参见获取项目ID和名称。 约束限制：1 - 64字符，字母、数字和中划线。 取值范围：不涉及。 默认取值：不涉及。 |
|
workflow_id |
是 |
String |
参数解释：工作流的ID。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
|
schedule_id |
是 |
String |
参数解释：工作流调度信息ID。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
content |
否 |
Map<String,Object> |
参数解释：内容。 约束限制：不涉及。 |
|
enable |
否 |
Boolean |
参数解释：使能标志。 约束限制：不涉及。 取值范围：
默认取值：不涉及。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
type |
String |
参数解释：类型，仅支持time（时间）。 取值范围：不涉及。 |
|
content |
Map<String,String> |
参数解释：内容。 |
|
action |
String |
参数解释：动作，仅支持run。 取值范围：不涉及。 |
|
workflow_id |
String |
参数解释：Workflow工作流ID。 取值范围：不涉及。 |
|
user_id |
String |
参数解释：用户ID。 取值范围：不涉及。 |
|
enable |
Boolean |
参数解释：定时调度信息，使能标记。 取值范围：
|
|
uuid |
String |
参数解释：ID标记。 取值范围：不涉及。 |
|
policies |
WorkflowSchedulePoliciesResp object |
参数解释：调度策略。 |
|
created_at |
String |
参数解释：创建时间。 取值范围：不涉及。 |
请求示例
更新调度信息
PUT https://{endpoint}/v2/{project_id}/workflows/{workflow_id}/schedules/fa4ac58e-088b-4fd7-ae8c-b36fee50f884
{
"content" : {
"cron" : "0 0 0 * * Thu,Tue",
"method" : "fixed"
},
"enable" : true
}
响应示例
状态码：200
返回调度信息。
{
"created_at" : "2022-11-02T09:40:52.714657+08:00",
"uuid" : "fa4ac58e-088b-4fd7-ae8c-b36fee50f884",
"type" : "time",
"content" : {
"cron" : "0 0 0 * * Thu,Tue",
"method" : "fixed"
},
"action" : "run",
"policies" : {
"on_failure" : "retry",
"on_running" : "cancel"
},
"workflow_id" : "f1642618-43eb-4ab1-a0b1-9cc584182c60",
"user_id" : "75540c679ab44074bc100022d8a4b204",
"enable" : true
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
返回调度信息。 |
错误码
请参见错误码。
