创建工作流定时调度 - CreateWorkflowSchedule

功能介绍

创建工作流定时调度接口用于为指定的工作流设置定时调度任务。

该接口适用于以下场景：当用户希望定期执行某个工作流，例如数据处理、模型训练等任务时，可以通过此接口配置定时调度。使用该接口的前提条件是用户已登录并具有对目标工作流的管理权限，且目标工作流已存在。创建操作完成后，将根据配置的调度规则自动执行工作流。若工作流不存在或用户无权限操作，接口将返回相应的错误信息。

接口约束

无

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。获取该接口关联的CLI示例： hcloud ModelArts CreateWorkflowSchedule。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  modelarts:workflow:update	Write	workflow *	-	-	-

URI

POST /v2/{project_id}/workflows/{workflow_id}/schedules

请求参数

响应参数

状态码：201

请求示例

创建Workflow定时调度。设置类型为“time”，动作为“run”，调度策略on_failure为“retry”、on_running为“cancel”。

POST https://{endpoint}/v2/{project_id}/workflows/{workflow_id}/schedules

{
  "type" : "time",
  "action" : "run",
  "content" : {
    "cron" : "0 0 0 * * Thu",
    "method" : "fixed"
  },
  "policies" : {
    "on_failure" : "retry",
    "on_running" : "cancel"
  }
}

响应示例

状态码：201

定时调度信息。

{
  "created_at" : "2022-11-02T09:40:52.714656752+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
}

状态码

错误码

请参见错误码。