调用ListSandboxes接口获取沙箱列表-函数计算-阿里云

列出 Sandbox。

接口说明

获取当前用户的所有沙箱列表，支持按模板名称过滤，支持分页查询。

调试

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

调试

授权信息

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

请求语法

GET /2025-09-10/sandboxes HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
templateName	string	否	模板名称	templateName
templateType	string	否	模板类型	TASK
maxResults	integer	否	页码	1000
nextToken	string	否	分页游标。说明该字段不为空，表示有更多数据。	dnLkmeaJc9vHgbzREh2l0J4dD+2BRJj42DLT6GrZysw=
status	string	否	状态	CREATING

返回参数

名称	类型	描述	示例值
	ListSandboxesResult	返回列表结构体的结果

示例

正常返回示例

JSON格式

{
  "code": "SUCCESS",
  "requestId": "55D4BE40-2811-5CFB-8482-E0E98D575B1E",
  "data": {
    "nextToken": "",
    "items": [
      {
        "sandboxId": "01KAWBP6JQD0J3Z34BP4WMX1KG",
        "templateId": "8d409d30-cac1-445a-95d5-476c47780336.schema",
        "templateName": "my-template",
        "status": "READY",
        "createdAt": "2025-11-26T10:54:17.770719+08:00",
        "lastUpdatedAt": "2025-11-26T10:54:17.770719+08:00",
        "sandboxIdleTimeoutSeconds": 1800,
        "endedAt": "2025-11-26T10:54:17.770719+08:00",
        "sandboxArn": "acs:ram::1760720386195983:role/aliyunfcdefaultrole",
        "sandboxIdleTTLInSeconds": 0,
        "metadata": {}
      }
    ]
  }
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2025-11-23	API 内部配置变更，不影响调用	查看变更详情
2025-11-20	新增 OpenAPI	查看变更详情