创建流程
功能介绍
创建流程
URI
POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/workflows
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
eihealth_project_id |
是 |
String |
平台项目ID,您可以在平台单击所需的项目名称,进入项目设置页面查看。 最小长度:1 最大长度:128 |
|
project_id |
是 |
String |
华为云项目ID,您可以从获取项目ID中获取。 最小长度:1 最大长度:128 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限,获取Token接口响应消息头中X-Subject-Token的值即为Token。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
流程名称,取值范围[1,56],允许大小写字母、数字、以及特殊字符中划线(-)和下划线(_)。更新流程时,流程名称不支持修改。 最小长度:1 最大长度:56 |
|
version |
是 |
String |
流程版本,取值范围[1,24],以小写字母或数字或大写字母开头,允许出现中划线,必须以小写字母或数字或大写字母结尾。更新流程时,流程版本不支持修改。 最小长度:1 最大长度:24 |
|
summary |
否 |
String |
流程简述 取值范围[0,128] 最小长度:0 最大长度:128 |
|
description |
否 |
String |
流程描述 取值范围[0,65535],后续支持markdown文本 最小长度:0 最大长度:65535 |
|
labels |
否 |
Array of strings |
流程标签,取值范围[0,5],单个标签最大长度32字符,支持中文、字母、数字、空格、下划线和中划线,且不能以空格开头或者结尾。 最小长度:1 最大长度:32 数组长度:0 - 5 |
|
timeout |
否 |
Integer |
流程超时时间,取值范围[1,144000],单位分钟,默认1440 最小值:1 最大值:144000 |
|
output_dir |
否 |
String |
流程的当前工作目录,默认为根目录,用户可显式指定;输出路径必须以斜杠(/)开头且不能以斜杠(/)结尾,不能包含两个以上相邻的斜杠(/),不能包含以下特殊字符:\ : ; * ? < " > | 。其中单个文件夹名称不能以中划线(-)开头,不能以英文句号(.)或斜杠(/)或空格开头或结尾 最小长度:0 最大长度:128 |
|
tasks |
否 |
Array of TaskDto objects |
流程中子任务的描述信息,子任务数量取值范围:[1,64] 数组长度:0 - 64 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
task_name |
是 |
String |
子任务实际名称,取值范围[1,32],只能以大小写字母开头,由大小写字母、数字、中划线(-)、下划线(_)组成,以大小写字符或数字结尾。 最小长度:1 最大长度:32 |
|
app_id |
是 |
String |
应用id,取值范围[1,135],正则先不能有中文,两种格式。特殊id,采用{app_name}::{app_version}::{src_project_name}格式,用于手动创建场景;其他场景,app_id为系统分配的唯一标识 最小长度:1 最大长度:135 |
|
display_name |
否 |
String |
流程的子任务展示名称,最大长度64 最小长度:0 最大长度:64 |
|
output_dir |
否 |
String |
子任务的输出存放路径,用户可显式指定;输出路径必须以斜杠(/)开头且不能以斜杠(/)结尾,不能包含两个以上相邻的斜杠(/),不能包含以下特殊字符:\ : ; * ? < " > | 。其中单个文件夹名称不能以中划线(-)开头,不能以英文句号(.)或斜杠(/)或空格开头或结尾 最小长度:0 最大长度:128 |
|
resources |
否 |
TaskResourceDto object |
子任务运行资源信息 |
|
location |
否 |
VertexLocationDto object |
子任务画布坐标信息 |
|
inputs |
否 |
Array of TaskParameterDto objects |
任务的输入参数信息 数组长度:0 - 128 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
cpu |
否 |
String |
cpu申请使用量,取值范围[0.1-128],单位C,支持一位小数。对于应用,不填默认1C;对于流程和作业,不填默认使用前一级的配置,填值会覆盖更新。覆盖关系:作业->流程->应用 最小长度:0 最大长度:24 |
|
cpu_type |
否 |
String |
cpu架构类型,不填默认X86 最小长度:0 最大长度:24 |
|
memory |
否 |
String |
内存申请使用量,取值范围[0.1-3072],单位G,支持一位小数。对于应用,不填默认1G;对于流程和作业,不填默认使用前一级的配置,填值会覆盖更新。覆盖关系:作业->流程->应用 最小长度:0 最大长度:24 |
|
gpu_type |
否 |
String |
gpu架构类型,取值范围 ' '|GPU|Snt9|D310。对于流程和作业,不填默认使用前一级的配置,填值会覆盖更新。覆盖关系:作业->流程->应用 最小长度:0 最大长度:24 |
|
gpu |
否 |
String |
gpu申请使用量,取值范围[0-16],仅支持整数,Snt9有特殊约束,申请数量需要是0,1,2,4,8。对于应用,不填默认0;对于流程和作业,不填默认使用前一级的配置,填值会覆盖更新。覆盖关系:作业->流程->应用 最小长度:0 最大长度:24 |
响应参数
状态码: 201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
流程id |
请求示例
创建流程,流程的名称为demo-workflow,版本为1.0.0。
https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/workflows
{
"name" : "demo-workflow",
"version" : "1.0.0",
"summary" : "summary",
"description" : "description",
"labels" : [ "labelA", "labelB" ],
"timeout" : 1440,
"output_dir" : "/workflow",
"tasks" : [ {
"task_name" : "app1-1",
"app_id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1",
"display_name" : "步骤1",
"output_dir" : "/task",
"resources" : {
"cpu_type" : "X86",
"cpu" : "1C",
"memory" : "1G",
"gpu_type" : "GPU",
"gpu" : 0
},
"location" : {
"x" : 100,
"y" : 100
},
"inputs" : [ {
"name" : "dir-parameter",
"values" : [ "/test" ]
} ]
} ]
}
响应示例
状态码: 201
CREATED
{
"id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1"
}
状态码
|
状态码 |
描述 |
|---|---|
|
201 |
CREATED |
错误码
请参见错误码。