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

创建notebook

功能介绍

创建notebook。

URI

POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/notebooks

表1 路径参数

参数

是否必选

参数类型

描述

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]的字符。

默认取值

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

description

String

参数解释

描述信息。

约束限制

不涉及

取值范围

长度为[0-1024]的字符。

默认取值

不涉及

storages

Array of NotebookStorage objects

参数解释

挂载信息。

约束限制

元素长度为[1-6]。

取值范围

不涉及

默认取值

不涉及

flavor

FlavorInfo object

参数解释

notebook规格。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

image

NotebookImage object

参数解释

镜像信息。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

name

String

参数解释

notebook名称。

约束限制

不涉及

取值范围

长度为[1-63],仅支持小写字母、数字、中划线(-),只能是小写字母开头,小写字母或数字结尾。

默认取值

不涉及

表4 NotebookStorage

参数

是否必选

参数类型

描述

path

String

参数解释

notebook存储路径。

约束限制

不涉及

取值范围

长度为[1-4096]的字符。

默认取值

不涉及

mount_path

String

参数解释

挂载路径,由于目前暂不支持自定义挂载,暂不开放。

约束限制

不涉及

取值范围

长度为[1-4096]的字符。

默认取值

不涉及

表5 FlavorInfo

参数

是否必选

参数类型

描述

cpu_type

String

参数解释

cpu架构类型。

约束限制

不涉及

取值范围

  • X86: X86架构

  • ARM:ARM架构

默认取值

X86

cpu

Float

参数解释

notebook占用的cpu, 0.1核为100m,单位为“C”。

约束限制

不涉及

取值范围

1-128之间的浮点数。

默认取值

1

gpu

Float

参数解释

notebook占用的gpu,0.1为使用单卡10%,1为占满单个显卡,1+为使用多个显卡。

约束限制

不涉及

取值范围

0-16之间的浮点数。

默认取值

0

gpu_type

String

参数解释

gpu架构类型。

约束限制

不涉及

取值范围

  • GPU:支持GPU

  • Snt9:支持Snt9

默认取值

不涉及

memory

Float

参数解释

notebook占用的内存,单位为“G”。

约束限制

不涉及

取值范围

范围[2-512]。

默认取值

2

表6 NotebookImage

参数

是否必选

参数类型

描述

image_type

String

参数解释

镜像类型。

约束限制

不涉及

取值范围

  • SYSTEM:系统预置

  • CUSTOMER:自定义

默认取值

不涉及

image_info

ImageInfo object

参数解释

镜像信息。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表7 ImageInfo

参数

是否必选

参数类型

描述

source_project_name

String

参数解释

源空间名。

约束限制

不涉及

取值范围

长度为[1-128]的字符。

默认取值

不涉及

image_name

String

参数解释

镜像名。

约束限制

不涉及

取值范围

长度为[1-128]的字符,支持小写字母、数字、中划线(-)、下划线(_)、点(.)和斜杠(/)。

默认取值

不涉及

image_tag

String

参数解释

镜像tag名。

约束限制

不涉及

取值范围

长度为[1-64]的字符,支持大小写字母、数字、中划线(-)、下划线(_)、点(.)和斜杠(/)。

默认取值

不涉及

profile

String

参数解释

系统镜像名。

约束限制

不涉及

取值范围

仅支持PY3

默认取值

不涉及

响应参数

状态码:201

表8 响应Body参数

参数

参数类型

描述

id

String

参数解释

notebook ID。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

请求示例

创建notebook,使用系统默认镜像,需要cpu资源1C,内存资源5G。

https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/notebooks

{
  "flavor" : {
    "cpu" : 1,
    "cpu_type" : "X86",
    "gpu" : 0,
    "gpu_type" : "GPU",
    "memory" : 5
  },
  "image" : {
    "image_type" : "SYSTEM",
    "image_info" : {
      "profile" : "PY3"
    }
  },
  "storages" : [ {
    "path" : "OBSFS:test-bucket:/"
  } ],
  "name" : "test-notebook",
  "description" : "test"
}

响应示例

状态码:201

CREATED

{
  "id" : "fce1376b-72f9-4d15-9f95-9b533cb96fda"
}

状态码

状态码

描述

201

CREATED

错误码

请参见错误码

相关文档