文档首页/ AI开发平台ModelArts/ API参考/ Workflow工作流管理/ 新建Workflow Execution

更新时间：2024-10-23 GMT+08:00

查看PDF

新建Workflow Execution

功能介绍

创建Workflow Execution。

接口约束

无

调试

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

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	用户项目ID。获取方法请参见获取项目ID和名称。
workflow_id	是	String	工作流的ID。

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
created_at	否	String	创建时间。
name	否	String	执行记录名称。
execution_id	否	String	工作流执行ID。
description	否	String	执行记录描述。
status	否	String	执行记录状态。
workspace_id	否	String	工作空间ID。
workflow_id	否	String	Workflow工作流ID。
workflow_name	否	String	工作流名称。填写1-64位，仅包含英文、数字、下划线（_）和中划线（-），并且以英文开头的名称。
scene_id	否	String	自定义场景ID。
scene_name	否	String	自定义场景名称。
steps_execution	否	Array of StepExecution objects	执行记录的step。
sub_graphs	否	Array of WorkflowSubgraph objects	子图。
duration	否	String	执行的时长。
events	否	Array of strings	执行的事件。
labels	否	Array of strings	为执行记录设置的标签。
data_requirements	否	Array of DataRequirement objects	节点steps使用到的数据。
parameters	否	Array of WorkflowParameter objects	节点steps使用到的参数。
policies	否	WorkflowDagPolicies object	执行记录使用到的执行策略。

表3 StepExecution
参数	是否必选	参数类型	描述
step_name	否	String	节点的名称，在一个DAG中唯一，1到64位只包含中英文，数字，空格，下划线（_）和中划线（-），并且以中英文开头。
duration	否	Integer	Execution执行的运行时长。
type	否	String	节点的类型。
instance_id	否	String	实例ID。
status	否	String	节点的状态。枚举值如下： init：初始化 wait_inputs：等待输入 pending：等待 creating：创建中 created：创建成功 create_failed：创建失败 running：运行中 stopping：停止中 stopped：停止 timeout：超时 completed：完成 failed：失败 hold：持有 skipped：跳过
inputs	否	Array of JobInput objects	节点的输入项。
outputs	否	Array of JobOutput objects	节点的输出项。
step_uuid	否	String	节点的UUID，唯一性标识。
properties	否	Map<String,Object>	节点的属性。
events	否	Array of strings	节点发生的事件。
error_info	否	WorkflowErrorInfo object	Execution执行的错误信息。
policy	否	WorkflowStepExecutionPolicy object	节点的执行策略。
conditions_execution	否	WorkflowConditionExecution object	条件执行。
step_title	否	String	节点标题。
conditions	否	Array of StepCondition objects	条件节点执行条件。

表4 JobInput
参数	是否必选	参数类型	描述
name	否	String	输入数据的名称，支持1到64位只包含英文、数字、下划线（_）和中划线（-）的字符。
type	否	String	输入项类型。枚举值如下： dataset：数据集 obs：OBS data_selector：数据选择
data	否	Object	输入项数据。
value	否	Object	输入项的值。

表5 JobOutput
参数	是否必选	参数类型	描述
name	否	String	输出数据的名称。
type	否	String	输出项类型。枚举值如下： obs：OBS model：AI应用元模型
config	否	Map<String,Object>	输出配置。

表6 WorkflowErrorInfo
参数	是否必选	参数类型	描述
error_code	否	String	错误码。
error_message	否	String	错误信息。

表7 WorkflowStepExecutionPolicy
参数	是否必选	参数类型	描述
execution_policy	否	String	执行策略，可选值如下： retry：重试 stop：停止 continue：继续运行
use_cache	否	Boolean	是否使用的是缓存。

表8 WorkflowConditionExecution
参数	是否必选	参数类型	描述
result	否	String	执行结果。
metric_list	否	Array of WorkflowMetricPair objects	工作流度量信息列表。

表9 WorkflowMetricPair
参数	是否必选	参数类型	描述
key	否	String	度量信息metric的key。
value	否	Object	度量信息metric的值。

**表10** StepCondition
参数	是否必选	参数类型	描述
type	否	String	判断类型，例如==（等于）、!=（不等于）、>（大于）、>=（大于等于）、<（小于）、<=（小于等于）、in（包含）、or（或）。
left	否	Object	节点执行条件为true时的分支。
right	否	Object	节点执行条件为false时的分支。

**表11** WorkflowSubgraph
参数	是否必选	参数类型	描述
name	否	String	子图名称。
steps	否	Array of strings	子图step成员。

**表12** DataRequirement
参数	是否必选	参数类型	描述
name	是	String	训练数据的名称。填写1-64位，仅包含英文、数字、下划线（_）和中划线（-），并且以英文开头的名称。
type	是	String	数据来源类型。枚举值如下： dataset：数据集 obs：OBS swr：SWR model_list：AI应用列表 label_task：标注任务 service：在线服务
conditions	否	Array of Constraint objects	数据约束条件。
value	否	Map<String,Object>	数据的值。
used_steps	否	Array of strings	使用了这条数据的工作流节点。
delay	否	Boolean	延时参数标记。

**表13** Constraint
参数	是否必选	参数类型	描述
attribute	否	String	条件属性，参数的某个字段值。
operator	否	String	操作，当前只支持equal操作。
value	否	Object	取值。

**表14** WorkflowParameter
参数	是否必选	参数类型	描述
name	否	String	Workflow工作流配置参数的名称。填写1-64位，仅包含英文、数字、下划线（_）和中划线（-），并且以英文开头的名称。
type	否	String	参数的类型，枚举值如下: str：字符串 int：整型 bool：布尔类型 float：浮点型
description	否	String	Workflow工作流配置参数的描述。
example	否	Object	Workflow工作流配置参数的样例。
delay	否	Boolean	是否为延迟输入的参数，默认为否。
default	否	Object	配置参数的默认值。
value	否	Object	参数值。
enum	否	Array of objects	Workflow工作流配置参数的枚举项。
used_steps	否	Array of strings	使用这个参数的工作流节点。
format	否	String	数据格式。
constraint	否	Map<String,Object>	限制条件。

**表15** WorkflowDagPolicies
参数	是否必选	参数类型	描述
use_cache	否	Boolean	是否使用缓存。

响应参数

状态码： 201

**表16** 响应Body参数
参数	参数类型	描述
created_at	String	创建时间。
name	String	执行记录名称。
execution_id	String	工作流执行ID。
description	String	执行记录描述。
status	String	执行记录状态。
workspace_id	String	工作空间ID。
workflow_id	String	Workflow工作流ID。
workflow_name	String	工作流名称。填写1-64位，仅包含英文、数字、下划线（_）和中划线（-），并且以英文开头的名称。
scene_id	String	自定义场景ID。
scene_name	String	自定义场景名称。
steps_execution	Array of StepExecution objects	执行记录的step。
sub_graphs	Array of WorkflowSubgraph objects	子图。
duration	String	执行的时长。
events	Array of strings	执行的事件。
labels	Array of strings	为执行记录设置的标签。
data_requirements	Array of DataRequirement objects	节点steps使用到的数据。
parameters	Array of WorkflowParameter objects	节点steps使用到的参数。
policies	WorkflowDagPolicies object	执行记录使用到的执行策略。

**表17** StepExecution
参数	参数类型	描述
step_name	String	节点的名称，在一个DAG中唯一，1到64位只包含中英文，数字，空格，下划线（_）和中划线（-），并且以中英文开头。
uuid	String	唯一标识uuid。创建节点执行时，后台自动生成。
created_at	String	Execution执行的创建时间。
duration	Integer	Execution执行的运行时长。
type	String	节点的类型。
instance_id	String	实例ID。
status	String	节点的状态。枚举值如下： init：初始化 wait_inputs：等待输入 pending：等待 creating：创建中 created：创建成功 create_failed：创建失败 running：运行中 stopping：停止中 stopped：停止 timeout：超时 completed：完成 failed：失败 hold：持有 skipped：跳过
inputs	Array of JobInput objects	节点的输入项。
outputs	Array of JobOutput objects	节点的输出项。
step_uuid	String	节点的UUID，唯一性标识。
properties	Map<String,Object>	节点的属性。
events	Array of strings	节点发生的事件。
error_info	WorkflowErrorInfo object	Execution执行的错误信息。
policy	WorkflowStepExecutionPolicy object	节点的执行策略。
conditions_execution	WorkflowConditionExecution object	条件执行。
step_title	String	节点标题。
conditions	Array of StepCondition objects	条件节点执行条件。

**表18** JobInput
参数	参数类型	描述
name	String	输入数据的名称，支持1到64位只包含英文、数字、下划线（_）和中划线（-）的字符。
type	String	输入项类型。枚举值如下： dataset：数据集 obs：OBS data_selector：数据选择
data	Object	输入项数据。
value	Object	输入项的值。

**表19** JobOutput
参数	参数类型	描述
name	String	输出数据的名称。
type	String	输出项类型。枚举值如下： obs：OBS model：AI应用元模型
config	Map<String,Object>	输出配置。

**表20** WorkflowErrorInfo
参数	参数类型	描述
error_code	String	错误码。
error_message	String	错误信息。

**表21** WorkflowStepExecutionPolicy
参数	参数类型	描述
execution_policy	String	执行策略，可选值如下： retry：重试 stop：停止 continue：继续运行
use_cache	Boolean	是否使用的是缓存。

**表22** WorkflowConditionExecution
参数	参数类型	描述
result	String	执行结果。
metric_list	Array of WorkflowMetricPair objects	工作流度量信息列表。

**表23** WorkflowMetricPair
参数	参数类型	描述
key	String	度量信息metric的key。
value	Object	度量信息metric的值。

**表24** StepCondition
参数	参数类型	描述
type	String	判断类型，例如==（等于）、!=（不等于）、>（大于）、>=（大于等于）、<（小于）、<=（小于等于）、in（包含）、or（或）。
left	Object	节点执行条件为true时的分支。
right	Object	节点执行条件为false时的分支。

**表25** WorkflowSubgraph
参数	参数类型	描述
name	String	子图名称。
steps	Array of strings	子图step成员。

**表26** DataRequirement
参数	参数类型	描述
name	String	训练数据的名称。填写1-64位，仅包含英文、数字、下划线（_）和中划线（-），并且以英文开头的名称。
type	String	数据来源类型。枚举值如下： dataset：数据集 obs：OBS swr：SWR model_list：AI应用列表 label_task：标注任务 service：在线服务
conditions	Array of Constraint objects	数据约束条件。
value	Map<String,Object>	数据的值。
used_steps	Array of strings	使用了这条数据的工作流节点。
delay	Boolean	延时参数标记。

**表27** Constraint
参数	参数类型	描述
attribute	String	条件属性，参数的某个字段值。
operator	String	操作，当前只支持equal操作。
value	Object	取值。

**表28** WorkflowParameter
参数	参数类型	描述
name	String	Workflow工作流配置参数的名称。填写1-64位，仅包含英文、数字、下划线（_）和中划线（-），并且以英文开头的名称。
type	String	参数的类型，枚举值如下: str：字符串 int：整型 bool：布尔类型 float：浮点型
description	String	Workflow工作流配置参数的描述。
example	Object	Workflow工作流配置参数的样例。
delay	Boolean	是否为延迟输入的参数，默认为否。
default	Object	配置参数的默认值。
value	Object	参数值。
enum	Array of objects	Workflow工作流配置参数的枚举项。
used_steps	Array of strings	使用这个参数的工作流节点。
format	String	数据格式。
constraint	Map<String,Object>	限制条件。

**表29** WorkflowDagPolicies
参数	参数类型	描述
use_cache	Boolean	是否使用缓存。

请求示例

启动工作流

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

{ }

响应示例

状态码： 201

{
  "created_at" : "2022-11-01T21:36:04.264564372+08:00",
  "name" : "execution-065",
  "execution_id" : "46c682b6-0310-4774-9c8e-62d7fb7e0b55",
  "description" : "",
  "workspace_id" : "0",
  "workflow_id" : "f1642618-43eb-4ab1-a0b1-9cc584182c60",
  "workflow_name" : "workflow_model_service_no_modify_xiahou_copy",
  "steps_execution" : null,
  "duration" : 0,
  "data_requirements" : [ {
    "name" : "model_input",
    "type" : "obs",
    "conditions" : [ {
      "attribute" : "object_type",
      "operator" : "equal",
      "value" : "directory"
    } ],
    "value" : {
      "object_type" : [ "DIRECTORY" ],
      "obs_url" : "/test-crq/train_output/"
    },
    "used_steps" : [ "model_step" ]
  }, {
    "name" : "service_model",
    "type" : "model_list",
    "delay" : true,
    "conditions" : [ {
      "attribute" : "model_name",
      "operator" : "equal",
      "value" : "lh-xh"
    } ],
    "used_steps" : [ "service_step" ]
  } ],
  "parameters" : [ {
    "name" : "schedule_d5sm",
    "type" : "int",
    "format" : "schedule",
    "description" : "Set how long the deployed service will stop in hours, where -1 means the service will always run",
    "delay" : true,
    "used_steps" : [ "service_step" ]
  } ],
  "policies" : { }
}

状态码

状态码	描述
201	OK

错误码

请参见错误码。

父主题： Workflow工作流管理

上一篇：获取Execution列表

下一篇：删除Workflow Execution

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

新建Workflow Execution

功能介绍

接口约束

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线