查询快照列表

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

请求头（Request Header）

请求参数（Request Parameters）

名称	类型	必须	位置	描述
workspace_id	string	是	path	工作空间 ID，获取方式可以参考快速开始
filter	string	否	query	过滤条件
order_by	string	否	query	排序
page_size	integer	否	query	每页条数
page_token	string	否	query	翻页 token

响应（Response）

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

字段	类型	描述
snapshots	array[object]	快照列表
next_page_token	string	下一页 token
total_size	integer	总记录数

其中snapshots的参数如下：

名称	类型	描述
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）

• 正常响应

{
  "snapshots": [
    {
      "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:40:12.875Z",
        "update_time": "2025-08-26T14:40:12.875Z"
      },
      "resource_limits": {
        "cpu": 0,
        "memory": 0,
        "storage": 0
      },
      "command": "string",
      "creator": "string",
      "updator": "string",
      "create_time": "2025-08-26T14:40:12.875Z",
      "update_time": "2025-08-26T14:40:12.875Z"
    }
  ],
  "next_page_token": "string",
  "total_size": 0
}