列出存储卷

POST

/storage/volume/list

列出当前用户的所有存储卷。

鉴权说明

你可以在请求头中找到 AccessToken，也可以直接从网页上复制（Auth Token）。该 Token 在你每次登录时生成，并且一天后过期。
你也可以通过调用 登录接口 获取新的 Token。

请求时需要把 AccessToken 作为 Cookie 传递。在下方的 cURL 示例中，可以看到使用 -b 传递 Token 的方式：

-b 'AccessToken=your_token_here'

注意：请将 your_token_here 替换为你实际的 AccessToken。该 Token 是一个 JWT (JSON Web Token)，包含了用户认证信息与权限。

请求体参数

请求体包含分页参数：

字段	类型	必填	描述
pager	object	是	分页配置

Pager 配置说明

字段	类型	必填	描述
currentPage	number	是	当前页码（从 1 开始）
pageSize	number	是	每页条目数量

请求示例

{
  "pager": {
    "currentPage": 1,
    "pageSize": 10
  }
}

cURL 示例

curl 'https://cloud.luchentech.com/api/storage/volume/list' \
  -H 'content-type: application/json' \
  -b 'AccessToken=your_token_here' \
  --data-raw '{"pager":{"currentPage":1,"pageSize":10}}'

响应字段

字段	类型	描述
volumeList	array	存储卷对象数组

存储卷对象字段

字段	类型	描述
id	string	存储卷唯一 ID
volumeName	string	存储卷名称
region	string	存储卷所在区域 ID
volumeType	string	存储卷类型（filesystem, highspeedstorage）
sizeGB	number	卷总大小（GB）
usageGB	number	已使用空间（GB）
status	string	存储卷状态（Bound, Pending 等）
username	string	卷所属用户

响应示例

成功响应

{
  "volumeList": [
    {
      "id": "da18c47c-xxxx-xxxx-xxxx-f5289ab0c8c3",
      "volumeName": "example-volume",
      "region": "fce31a0c-xxxx-xxxx-xxxx-41caa1bdd251",
      "volumeType": "filesystem",
      "sizeGB": 200,
      "usageGB": 0,
      "status": "Bound",
      "username": "username"
    }
  ]
}

失败响应

{
  "code": -1,
  "message": "未登录或登录已过期，请重新登录"
}