获取流程详情
功能介绍
获取流程详情
URI
GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/workflows/{workflow_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
eihealth_project_id |
是 |
String |
平台项目ID,您可以在平台单击所需的项目名称,进入项目设置页面查看。 最小长度:1 最大长度:128 |
|
project_id |
是 |
String |
华为云项目ID,您可以从获取项目ID中获取。 最小长度:1 最大长度:128 |
|
workflow_id |
是 |
String |
流程id 最小长度:1 最大长度:128 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Show-Param-Detail |
否 |
Boolean |
是否显示模板参数详情 |
|
X-Auth-Token |
是 |
String |
用户Token。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限,获取Token接口响应消息头中X-Subject-Token的值即为Token。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
流程id |
|
name |
String |
流程名称 |
|
version |
String |
流程版本 |
|
summary |
String |
流程简述 |
|
description |
String |
流程描述 |
|
labels |
Array of strings |
流程标签 |
|
timeout |
Integer |
超时时间 |
|
output_dir |
String |
流程的输出路径 |
|
tasks |
Array of TaskDefinitionDto objects |
流程的子任务 |
|
app_snapshot_sign |
Map<String,String> |
流程创建时刻的应用快照,当query填workflow_snapshot_sign有值;K为appId,V为sign |
|
create_time |
String |
流程的创建时间 |
|
update_time |
String |
流程的更新时间 |
|
source_project_name |
String |
源项目名称 |
|
source_resource_id |
String |
源资源id |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
task_name |
String |
子任务实际名称 |
|
display_name |
String |
流程的子任务展示名称 |
|
output_dir |
String |
子任务的输出存放路径 |
|
whole_output_dir |
String |
子任务的完整输出路径,查看流程不会返回,查看作业时才会返回完整输出路径 |
|
io_acc_type |
String |
子任务使用的IO加速类型,不填表示不使用; |
|
resources |
TaskResourceDto object |
子任务对应资源信息 |
|
location |
VertexLocationDto object |
子任务的画布位置信息 |
|
inputs |
Array of TaskParameterDto objects |
子任务的输入参数信息 |
|
app_info |
AppInfoDto object |
子任务的应用信息 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
子任务的参数名称,长度为[1,32],以小写字母开头,允许出现中划线(-)、小写字母和数字,且必须以小写字母或数字结尾。需要和已有应用的参数名称一致。 最小长度:1 最大长度:32 |
|
source |
String |
子任务的参数类型,不填默认为MANUAL |
|
values |
Array of strings |
子任务的参数数值,根据参数类型进行合法性校验 最小长度:0 最大长度:2048 数组长度:0 - 128 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
app_id |
String |
应用id |
|
app_name |
String |
应用名称 |
|
app_version |
String |
应用版本 |
|
app_src_project_name |
String |
应用来源项目名称 |
|
app_labels |
Array of strings |
应用标签 |
|
app_summary |
String |
应用简述 |
|
app_description |
String |
应用描述 |
|
app_image |
String |
应用镜像 |
|
app_commands |
Array of strings |
任务使用到的应用自带的命令信息 |
|
app_input_parameters |
Array of AppInputParameterDto objects |
任务使用到的应用自带的输入参数信息 |
|
app_output_parameters |
Array of AppOutputParameterDto objects |
任务使用到的应用自带的输出参数信息 |
|
app_node_labels |
Array of strings |
计算节点标签 |
|
app_icon |
String |
图标base64编码 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
参数名称,单个应用内唯一。取值范围:长度为[1,32],以小写字母开头,允许出现中划线(-)、小写字母和数字,且必须以小写字母或数字结尾。 最小长度:1 最大长度:32 |
|
description |
String |
参数描述。取值范围:[0-255] 最小长度:0 最大长度:255 |
|
required |
Boolean |
参数是否必须 |
|
concurrent |
String |
参数是否开启并发。当前支持vars_iter并发类型,不填表示未开启并发。 |
|
type |
String |
参数类型。取值:[STRING,FILE,DIRECTORY,ENUM] |
|
pattern |
String |
提示用户参数填写的格式,取值范围:[0-64]。对于STRING类型,匹配字符串内容,比如后缀约束.fastq;对于ENUM类型,可以提示一定要在param_enum列表范围内取值;对于FILE类型,约束文件后缀类型;对于DIRECTORY类型,提示目录下需要包含哪些文件; 最小长度:0 最大长度:64 |
|
values |
Array of strings |
参数取值 如填写,只支持填一项,根据参数类型进行不同的校验 最小长度:0 最大长度:2048 数组长度:0 - 128 |
|
enum |
Array of strings |
枚举参数的取值列表,列表最大长度20,每一项字符串最长128。参数类型为ENUM时需要填此字段 最小长度:0 最大长度:128 数组长度:0 - 20 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
参数名称,单个应用内唯一。取值范围:长度为[1,32],以小写字母开头,允许出现中划线(-)、小写字母和数字,且必须以小写字母或数字结尾。 最小长度:1 最大长度:32 |
|
description |
String |
参数描述。取值范围:[0-255] 最小长度:0 最大长度:255 |
|
required |
Boolean |
参数是否必须 |
|
type |
String |
参数类型。取值:[STRING,FILE,DIRECTORY,ENUM] |
|
pattern |
String |
提示用户参数填写的格式,取值范围:[0-64]。对于STRING类型,匹配字符串内容,比如后缀约束.fastq;对于ENUM类型,可以提示一定要在param_enum列表范围内取值;对于FILE类型,约束文件后缀类型;对于DIRECTORY类型,提示目录下需要包含哪些文件; 最小长度:0 最大长度:64 |
|
values |
Array of strings |
参数取值 如填写,只支持填一项,根据参数类型进行不同的校验 最小长度:0 最大长度:2048 数组长度:0 - 128 |
|
enum |
Array of strings |
枚举参数的取值列表,列表最大长度20,每一项字符串最长128。参数类型为ENUM时需要填此字段 最小长度:0 最大长度:128 数组长度:0 - 20 |
请求示例
无
响应示例
状态码: 200
OK
{
"id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1",
"name" : "demo-workflow",
"version" : "1.0.0",
"summary" : "summary",
"description" : "description",
"labels" : [ "labelA", "labelB" ],
"timeout" : 1440,
"output_dir" : "/workflow",
"tasks" : [ {
"task_name" : "app1-1",
"display_name" : "步骤1",
"output_dir" : "/task",
"whole_output_dir" : "/workflow/task",
"io_acc_type" : "SFS",
"resources" : {
"cpu_type" : "X86",
"cpu" : "1C",
"memory" : "1G",
"gpu_type" : "GPU",
"gpu" : 0
},
"location" : {
"x" : 100,
"y" : 100
},
"inputs" : [ {
"name" : "dir-parameter",
"values" : [ "/test" ]
} ],
"app_info" : {
"app_id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1",
"app_name" : "demo-app",
"app_version" : "1.0.0",
"app_labels" : [ "labelA", "labelB" ],
"app_summary" : "summary",
"app_description" : "description",
"app_image" : "gwj-test-01/busybox:latest",
"app_commands" : [ "echo eihealth;" ],
"app_input_parameters" : [ {
"name" : "dir-parameter",
"description" : "parameter description",
"required" : true,
"type" : "DIRECTORY",
"pattern" : "*.fastq",
"values" : [ "/test" ]
} ],
"app_output_parameters" : [ {
"name" : "dir-parameter",
"description" : "parameter description",
"required" : true,
"type" : "DIRECTORY",
"pattern" : "*.fastq",
"values" : [ "/test" ]
} ]
}
} ],
"create_time" : "2021-01-30T02:34:36Z",
"update_time" : "2021-01-30T02:53:26Z"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。