ListSnapshots - 查询快照信息列表-函数计算(FC)-阿里云帮助中心

接口说明

该 API 用于列出当前账号下可见的用户 MicroSandbox 快照。
仅返回未过期且状态为 Available 的用户快照。
支持四种筛选方式：账号级列表、按函数过滤、按函数和源 SessionID 过滤、按函数、源 SessionID 和创建时 qualifier 过滤。
结果按创建时间和快照 ID 稳定降序分页。
ListSnapshots 使用搜索索引查询，短时间内可能存在最终一致性延迟；GetSnapshot 和使用快照创建 Session 以主表强读为准。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET /2023-03-30/snapshots HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
functionName	string	否	函数名称	my-func
sessionId	string	否	创建快照的源 SessionID。指定时必须同时指定 functionName。	test-session-id-1
qualifier	string	否	函数别名	alias
limit	integer	否	本次最多返回的快照数量，取值范围 1-100，默认 20。	20
nextToken	string	否	剩余列表的起始层名，用来返回更多结果。	caeba0be03****f84eb48b699f0a4883

返回参数

名称	类型	描述	示例值
	ListSnapshotsOutput	返回的快照信息列表

示例

正常返回示例

JSON格式

{
  "nextToken": "",
  "snapshots": [
    {
      "snapshotId": "550e8400-e29b-41d4-a716-446655440000",
      "status": "Available",
      "createdTime": "2026-07-30T10:00:00Z",
      "expiredTime": "2026-08-29T10:00:00Z",
      "description": "Snapshot for production environment",
      "sourceSessionId": "custom-test-session-id",
      "functionName": "my-function",
      "qualifier": "production",
      "resolvedVersion": "1",
      "imageRepository": "registry-vpc.cn-hangzhou.aliyuncs.com/example/function",
      "imageDigest": "sha256:0123456789abcdef",
      "osType": "linux",
      "memoryMB": 3072,
      "cpu": 2,
      "diskSizeMB": 10240,
      "artifactMemUsedSizeInB": 1073741824,
      "artifactDiskUsedSizeInB": 2147483648,
      "startCommand": "/code/start.sh",
      "readyCommand": "/code/ready.sh",
      "envs": {
        "key": ""
      }
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。