创建快照

POST https://sandbox.cn-sh-01.sensecoreapi.cn/studio/sandbox/v1/workspaces/{workspace_id}/snapshots

请求头（Request Header）

请求参数（Request Parameters）

名称	类型	必须	位置	描述
workspace_id	string	是	path	工作空间id，获取方式可以参考快速开始
name	string	是	body	快照名称
description	string	否	body	快照描述
image	object	是	body	镜像信息
resource_limits	object	是	body	资源规格
command	string	否	body	启动命令

其中，image的参数如下：

名称	类型	必须	描述
id	string	是	镜像ID

其中，resource_limits的参数如下：

名称	类型	必须	描述
cpu	integer	是	cpu核数，范围为1-96
memory	integer	是	内存规格，单位GiB，范围为1-384
storage	integer	是	存储规格，单位GiB，范围为1-960

响应（Response）

异常情况请参考异常响应说明

名称	类型	描述
workspace_id	string	工作空间ID
id	string	快照ID
name	string	快照名称
description	string	快照描述
image	object	快照所用镜像信息
resource_limits	object	资源规格设置
command	string	启动命令
creator	string	创建者
updator	string	更新者
create_time	string	创建时间
update_time	string	更新时间

其中，image的参数如下：

名称	类型	描述
id	string	镜像ID
name	string	镜像名称
type	string	镜像类型, IMAGE_TYPE_BUILT_IN为预置镜像
description	string	镜像描述
repository	string	镜像仓库地址
create_time	string	镜像创建时间
update_time	string	镜像更新时间

其中，resource_limits的参数如下：

名称	类型	描述
cpu	integer	cpu核数，最小为1核
memory	integer	内存规格，单位GiB，最小为1GiB
storage	integer	存储规格，单位GiB，最小为1GiB

响应示例（Response Example）

• 正常响应

{
  "workspace_id": "string",
  "id": "string",
  "name": "string",
  "description": "string",
  "image": {
    "id": "string",
    "name": "string",
    "type": "IMAGE_TYPE_BUILT_IN",
    "description": "string",
    "repository": "string",
    "create_time": "2025-08-26T14:45:52.153Z",
    "update_time": "2025-08-26T14:45:52.153Z"
  },
  "resource_limits": {
    "cpu": 0,
    "memory": 0,
    "storage": 0
  },
  "command": "string",
  "creator": "string",
  "updator": "string",
  "create_time": "2025-08-26T14:45:52.153Z",
  "update_time": "2025-08-26T14:45:52.153Z"