通过运行的实例保存成容器镜像
功能介绍
通过运行的实例保存成容器镜像接口用于将正在运行的实例保存为容器镜像。该接口适用于以下场景:用户需要保存当前运行环境以便后续使用或开发时,可通过此接口将实例保存为镜像。使用该接口的前提条件是用户已登录系统并具有访问目标实例的权限,同时实例必须处于运行状态。调用该接口后,系统将保存实例的当前状态为容器镜像,包括安装的依赖包和插件。若用户无权限访问指定实例或实例未运行,接口将返回相应的错误信息。
接口约束
暂无约束。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/notebooks/{id}/create-image
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
是 |
String |
参数解释:Notebook实例ID。ID格式为通用唯一识别码(Universally Unique Identifier,简称UUID),可通过调用查询Notebook实例列表接口获取。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
project_id |
是 |
String |
参数解释:用户项目ID,获取方法请参见获取项目ID和名称。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
description |
否 |
String |
参数解释:该镜像所对应的描述信息。 约束限制:不涉及。 取值范围:长度限制512个字符。 默认取值:不涉及。 |
name |
是 |
String |
参数解释:镜像名称。 约束限制:不涉及。 取值范围:长度限制为128个字符,支持小写字母、数字、中划线、下划线和点,字符串必须以小写字母或数字开头和结尾。 默认取值:不涉及。 |
namespace |
是 |
String |
参数解释:镜像所属组织,可以在SWR控制台“组织管理”创建和查看。 约束限制:不涉及。 取值范围:长度限制为64个字符,支持大小写字母、数字、中划线、下划线和点号,且必须是小写字母开头。 默认取值:不涉及。 |
tag |
否 |
String |
参数解释:镜像tag。 约束限制:不涉及。 取值范围:长度限制64个字符,支持大小写字母、数字、中划线、下划线和点号。 默认取值:不涉及。 |
workspace_id |
否 |
String |
参数解释:工作空间ID。获取方法请参见查询工作空间列表。未创建工作空间时默认值为“0”,存在创建并使用的工作空间,以实际取值为准。 约束限制:不涉及。 取值范围:不涉及。 默认取值:0。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
arch |
String |
参数解释:该镜像所支持处理器架构类型。 取值范围:枚举类型,取值如下:
|
create_at |
Long |
参数解释:镜像创建的时间,UTC毫秒。 取值范围:不涉及。 |
description |
String |
参数解释:该镜像所对应的描述信息。 取值范围:长度限制512个字符。 |
dev_services |
Array of strings |
参数解释:镜像支持的服务。 取值范围:枚举类型,取值如下:
|
id |
String |
参数解释:待创建Notebook实例的镜像,需要指定镜像ID,ID格式为通用唯一识别码(Universally Unique Identifier,简称UUID)。预置镜像的ID参考查询支持的镜像列表获取。 取值范围:不涉及。 |
name |
String |
参数解释:镜像名称。 取值范围:长度限制512个字符,支持小写字母、数字、中划线、下划线和点。 |
namespace |
String |
参数解释:镜像所属组织,可以在SWR控制台“组织管理”创建和查看。 取值范围:不涉及。 |
origin |
String |
参数解释:指定镜像来源。 取值范围:枚举类型,取值如下:
|
resource_categories |
Array of strings |
参数解释:镜像支持的规格。枚举类型,取值如下:
|
service_type |
String |
参数解释:镜像支持服务类型。 取值范围:枚举类型,取值如下:
|
size |
Long |
参数解释:镜像大小(单位KB)。 取值范围:不涉及。 |
status |
String |
参数解释:镜像状态。 取值范围:枚举类型,取值如下:
|
status_message |
String |
参数解释:镜像保存操作过程中,构建信息展示。 取值范围:不涉及。 |
support_res_categories |
Array of strings |
参数解释:镜像支持的规格。 枚举类型,取值如下:
|
swr_path |
String |
参数解释:SWR镜像地址。 取值范围:不涉及。 |
tag |
String |
参数解释:镜像Tag。 取值范围:不涉及。 |
type |
String |
参数解释:镜像类型。 取值范围:枚举类型,取值如下:
|
update_at |
Long |
参数解释:镜像最后更新的时间,UTC毫秒。 取值范围:不涉及。 |
visibility |
String |
参数解释:镜像可见度。 取值范围:枚举类型,取值如下:
|
workspace_id |
String |
参数解释:工作空间ID。未创建工作空间时默认值为“0”,存在创建并使用的工作空间,以实际取值为准。 取值范围:不涉及。 |
flavor_type |
String |
参数解释:镜像的资源类型。 取值范围:枚举类型,取值如下:
|
状态码:201
Created。
请求示例
将运行的实例可以保存成容器镜像。设置镜像名称为“pytorch1_4”,镜像所属组织为“atelier-auto”。
{ "name" : "pytorch1_4", "namespace" : "atelier-auto", "tag" : "20221223", "description" : "save from notebook-x21d", "workspace_id" : "0" }
响应示例
状态码:200
OK。
{ "arch" : "x86_64", "create_at" : 1671786468811, "description" : "notebook2.0 20200816", "dev_services" : [ "SSH", "NOTEBOOK" ], "id" : "4e0d1854-63e5-4517-b683-a0ee97a692a1", "name" : "pytorch1_4", "namespace" : "atelier-auto", "origin" : "IMAGE_SAVE", "resource_categories" : [ "CPU", "GPU" ], "service_type" : "TRAIN", "status" : "INIT", "swr_path" : "swr.xxxxx.com/atelier-auto/pytorch1_4:20221223", "tag" : "20221223", "type" : "DEDICATED", "update_at" : 1671786468811, "visibility" : "PRIVATE", "workspace_id" : "0" }
状态码
状态码 |
描述 |
---|---|
200 |
OK。 |
201 |
Created。 |
401 |
Unauthorized。 |
403 |
Forbidden。 |
404 |
Not Found。 |
错误码
请参见错误码。