更新时间:2024-04-03 GMT+08:00
分享

获取应用详情

功能介绍

获取应用详情

URI

GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/apps/{app_id}

表1 路径参数

参数

是否必选

参数类型

描述

app_id

String

应用id

最小长度:1

最大长度:128

eihealth_project_id

String

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

最小长度:1

最大长度:128

project_id

String

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

最小长度:1

最大长度:128

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

最小长度:1

最大长度:32768

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

id

String

应用id

name

String

应用名称

version

String

应用版本

summary

String

应用短描述

description

String

应用描述

labels

Array of strings

应用标签

image

String

应用镜像

commands

Array of strings

应用命令

resources

ResourceDto object

应用申请资源

inputs

Array of AppInputParameterDto objects

应用的输入参数信息

outputs

Array of AppOutputParameterDto objects

应用的输出参数信息

create_time

String

创建应用时间

update_time

String

更新应用时间

user_name

String

创建应用的用户名

source_project_name

String

源项目名称

source_resource_id

String

源资源id

node_labels

Array of strings

节点标签

icon

String

图标base64编码

表4 ResourceDto

参数

参数类型

描述

cpu_type

String

cpu架构类型,不填默认X86

最小长度:0

最大长度:24

cpu

String

cpu申请使用量,取值范围[0.1-128],单位C,支持一位小数。对于应用,不填默认1C;对于流程和作业,不填默认使用前一级的配置,填值会覆盖更新。覆盖关系:作业->流程->应用

最小长度: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

表5 AppInputParameterDto

参数

参数类型

描述

name

String

参数名称,单个应用内唯一。取值范围:长度为[1,32],以小写字母开头,允许出现中划线(-)、小写字母和数字,且必须以小写字母或数字结尾。

最小长度:1

最大长度:32

description

String

参数描述。取值范围:[0-255]

最小长度:0

最大长度:255

required

Boolean

参数是否必须

concurrent

String

参数是否开启并发。当前支持vars_iter并发类型,不填表示未开启并发。

最小长度:0

最大长度:16

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

表6 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-app",
  "version" : "1.0.0",
  "summary" : "summary",
  "description" : "description",
  "labels" : [ "labelA", "labelB" ],
  "image" : "gwj-test-01/busybox:latest",
  "commands" : [ "echo eihealth;" ],
  "resources" : {
    "cpu_type" : "X86",
    "cpu" : "1C",
    "memory" : "1G",
    "gpu_type" : "GPU",
    "gpu" : 0
  },
  "inputs" : [ {
    "name" : "dir-parameter",
    "description" : "parameter description",
    "required" : true,
    "concurrent" : "var_iter",
    "type" : "DIRECTORY",
    "pattern" : "*.fastq",
    "values" : [ "/test" ]
  } ],
  "outputs" : [ {
    "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",
  "user_name" : "gwj-test-01",
  "source_project_name" : "null",
  "source_resource_id" : "null",
  "node_labels" : [ "health.node" ],
  "icon" : "data:image/png;base64,xxxxx"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档