创建存储

POST

/storage/volume/create

创建一个新的存储。

授权 (Authorization)

你可以在请求头中找到 AccessToken，或者从网页端复制（Copy Auth Token）。 该 Token 会在你每次登录时生成，并且在 一天后过期。

你也可以调用 登录 API 来获取新的 Token，参见 login api。

在请求中，AccessToken 需要以 cookie 的形式传递。在下面的 cURL 示例中，可以看到如何使用 -b 参数传递：

-b 'AccessToken=your_token_here'

注意：请将 your_token_here 替换为实际的 AccessToken。该 Token 是一个 JWT（JSON Web Token），其中包含了你的身份认证信息和权限。

请求体 (Request Body)

请求体包含存储卷的配置信息：

字段	类型	必填	描述
name	string	是	存储卷的名称
sizeGB	number	是	存储卷大小（GB）
region	string	是	创建存储卷所在的区域 ID
volumeType	string	是	存储卷类型（filesystem, highspeedstorage 等）

---

示例请求 (Example Request)

{
  "name": "example-volume",
  "sizeGB": 200,
  "region": "fce31a0c-xxxx-xxxx-xxxx-41caa1bdd251",
  "volumeType": "filesystem"
}

cURL 示例

curl 'https://cloud.luchentech.com/api/storage/volume/create' \
  -H 'content-type: application/json' \
  -b 'AccessToken=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9....' \
  --data-raw '{"name":"example-volume2","sizeGB":200,"region":"fce31a0c-xxxx-xxxx-xxxx-41caa1bdd251","volumeType":"filesystem"}'

响应示例

成功响应

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

错误响应

{
  "message": "Volume already exists"
}