更新时间:2025-11-17 GMT+08:00
分享

查询工作流定时调度详情

功能介绍

查询工作流定时调度详情接口用于获取指定工作流的定时调度任务的详细信息。

该接口适用于以下场景:当用户需要查看某个工作流的定时调度配置,例如调度时间、执行频率等详细信息时,可以通过此接口获取相关信息。使用该接口的前提条件是用户已登录并具有查看目标工作流定时调度的权限,且目标工作流及其定时调度任务已存在。查询操作完成后,将返回定时调度任务的详细信息,包括调度规则、最近一次执行时间等。若工作流或定时调度任务不存在或用户无权限操作,接口将返回相应的错误信息。

接口约束

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v2/{project_id}/workflows/{workflow_id}/schedules/{schedule_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:用户项目ID。获取方法请参见获取项目ID和名称

约束限制:1 - 64字符,字母、数字和中划线。

取值范围:不涉及。

默认取值:不涉及。

workflow_id

String

参数解释:工作流的ID。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

schedule_id

String

参数解释:工作流调度信息ID。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

type

String

参数解释:类型,仅支持time(时间)。

取值范围:不涉及。

content

Map<String,String>

参数解释:内容。

action

String

参数解释:动作,仅支持run。

取值范围:不涉及。

workflow_id

String

参数解释:Workflow工作流ID。

取值范围:不涉及。

user_id

String

参数解释:用户ID。

取值范围:不涉及。

enable

Boolean

参数解释:定时调度信息,使能标记。

取值范围

  • true:生效

  • false:不生效

uuid

String

参数解释:ID标记。

取值范围:不涉及。

policies

WorkflowSchedulePoliciesResp object

参数解释:调度策略。

created_at

String

参数解释:创建时间。

取值范围:不涉及。

表3 WorkflowSchedulePoliciesResp

参数

参数类型

描述

on_failure

String

参数解释:定时调度策略中的标记,失败时触发。

取值范围:不涉及。

on_running

String

参数解释:定时调度策略中的标记,running时触发。

取值范围:不涉及。

请求示例

查询调度信息

GET https://{endpoint}/v2/{project_id}/workflows/{workflow_id}/schedules/fa4ac58e-088b-4fd7-ae8c-b36fee50f884

响应示例

状态码: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",
    "method" : "fixed"
  },
  "action" : "run",
  "policies" : {
    "on_failure" : "retry",
    "on_running" : "cancel"
  },
  "workflow_id" : "f1642618-43eb-4ab1-a0b1-9cc584182c60",
  "user_id" : "75540c679ab44074bc100022d8a4b204",
  "enable" : true
}

状态码

状态码

描述

200

工作流调度信息

错误码

请参见错误码

相关文档