更新时间:2024-07-12 GMT+08:00
分享

获取流程详情

功能介绍

获取流程详情

URI

GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/workflows/{workflow_id}

表1 路径参数

参数

是否必选

参数类型

描述

eihealth_project_id

String

平台项目ID,您可以在平台单击所需的项目名称,进入项目设置页面查看。

最小长度:1

最大长度:128

project_id

String

华为云项目ID,您可以从获取项目ID中获取。

最小长度:1

最大长度:128

workflow_id

String

流程id

最小长度:1

最大长度:128

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Show-Param-Detail

Boolean

是否显示模板参数详情

X-Auth-Token

String

用户Token。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限,获取Token接口响应消息头中X-Subject-Token的值即为Token。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

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

表4 TaskDefinitionDto

参数

参数类型

描述

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

子任务的应用信息

表5 TaskResourceDto

参数

参数类型

描述

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

表6 VertexLocationDto

参数

参数类型

描述

x

Double

子任务的画布横坐标

y

Double

子任务的画布纵坐标

表7 TaskParameterDto

参数

参数类型

描述

name

String

子任务的参数名称,长度为[1,32],以小写字母开头,允许出现中划线(-)、小写字母和数字,且必须以小写字母或数字结尾。需要和已有应用的参数名称一致。

最小长度:1

最大长度:32

source

String

子任务的参数类型,不填默认为MANUAL

values

Array of strings

子任务的参数数值,根据参数类型进行合法性校验

最小长度:0

最大长度:2048

数组长度:0 - 128

表8 AppInfoDto

参数

参数类型

描述

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编码

表9 AppInputParameterDto

参数

参数类型

描述

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

表10 AppOutputParameterDto

参数

参数类型

描述

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

错误码

请参见错误码

相关文档