查询工作流定时调度列表
功能介绍
查询工作流定时调度列表接口用于获取指定项目下所有工作流的定时调度信息。
该接口适用于以下场景：当用户需要查看项目中所有工作流的定时调度配置，以便进行任务管理和调度优化时，可以通过此接口获取定时调度列表。使用该接口的前提条件是用户已登录并具有查看工作流定时调度的权限。响应消息体中包含每个工作流的定时调度信息，如调度ID、调度时间、状态等。若用户无权限或项目下无工作流定时调度，接口将返回相应的错误信息或空列表。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v2/{project_id}/workflows/{workflow_id}/schedules
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释：用户项目ID。获取方法请参见获取项目ID和名称。 约束限制：1 - 64字符，字母、数字和中划线。 取值范围：不涉及。 默认取值：不涉及。 |
|
workflow_id |
是 |
String |
参数解释：工作流的ID。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
请求参数
无
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
schedules |
Array of WorkflowScheduleResp objects |
参数解释：工作流定时调度列表 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
参数解释：创建时间。 取值范围：不涉及。 |
请求示例
GET https://{endpoint}/v2/04f679b17380d32a2f32c00335c4b5ba/workflows/903aaa74-69fa-4e06-94b3-3c534cf5dcc0/schedules
响应示例
状态码：200
{
"schedules" : [ {
"created_at" : "2025-10-16T19:13:44+08:00",
"uuid" : "3a1f03cd-912c-410c-a0cf-c6645c9b3f4f",
"type" : "time",
"content" : {
"cron" : "4 0 10 * * zhu",
"method" : "fixed"
},
"action" : "run",
"policies" : {
"on_failure" : "retry",
"on_running" : "cancel"
},
"workflow_id" : "903aaa74-69fa-4e06-94b3-3c534cf5dcc0",
"user_id" : "7f734f075b77497986fb4fc624bb06dd",
"enable" : true
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
错误码
请参见错误码。
