存储池

查看存储池列表

接口描述

查看存储池列表。

接口路径

GET /v1/storages/pools

请求参数

参数名称	是否必须	示例	备注
datacenter_id	否	?datacenter_id=10	数据中心ID
storage_id	否	?storage_id=1	存储id（查看指定存储集群中可用的存储池）
server_id	否	?server_id=1	服务器id（查看指定服务器上可用的存储池）
category	否	?category=data	存储池类型（data or image）
limit	否	?limit=100	限制查询数量
offset	否	?offset=10	指定查询时跳过的数量

返回数据

名称	类型	描述
code	int	状态码（100001表示成功，其它表示异常）
msg	string	状态码描述信息
data	[]object	响应数据
reason	string	异常时的原因

返回数据示例：

{
    "code": 100001,
    "msg": "success",
    "data": {
        "count": 2,  // 储池数量
        "items": [
            {
                "id": 1,  // 存储池id
                "created_at": "2024-06-25T14:58:12.516+08:00", // 创建时间
                "updated_at": "2024-06-25T14:58:12.516+08:00", // 更新时间
                "name": "local_system", // 存储池名称
                "pool_name": "local_system", // 存储池名称
                "type": "dir",  // 存储池类型
                "category": "data",
                "disk_type": "SSD",
                "path": "/opt/srv/kvm",  // 存储池路径
                "status": "active",  // 存储池状态
                "public": false, // 是否是公共存储池
                "datacenter_id": 1, // 数据中心
                "server_id": 2,  // 服务器id
                "description": ""  // 存储池描述
            },
            {
                "id": 2,
                "created_at": "2024-06-25T14:58:12.52+08:00",
                "updated_at": "2024-06-25T14:58:12.52+08:00",
                "name": "baseimg",
                "pool_name": "baseimg",
                "type": "dir",
                "category": "image",
                "disk_type": "SSD",
                "path": "/opt/export/baseimg",
                "status": "active",
                "public": false,
                "datacenter_id": 1,
                "server_id": 2,
                "description": ""
            }
        ]
    }
}

创建存储池

接口描述

创建存储池。

接口路径

POST /v1/storages/pools

请求参数

参数名称	参数类型	是否必须	描述
name	string	是	存储池名称
type	string	是	存储池类型，可用值：dir、nfs、glusterfs
path	string	是	存储池路径
category	string	是	存储池种类（用于存放数据盘还是镜像，可用值：data、image）
storage_id	int	否	存储id（在指定存储中创建公共存储池，server_id和storage_id必须使用其中一个）
server_id	int	否	服务器Id（在指定服务器上创建私有存储池，server_id和storage_id必须使用其中一个）
description	string	否	存储池描述

请求示例：

# 在指定服务器上创建私有存储池
{
    "name": "vmdata",
    "type": "dir",
    "category": "data",
    "path": "/srv/pool/data",
    "server_id": 1
}

返回数据

名称	类型	描述
code	int	状态码（100001表示成功，其它表示异常）
msg	string	状态码描述信息
data	int	存储池id
reason	string	异常时的原因

删除存储池

接口描述

删除存储池。

接口路径

DELETE /v1/storages/pools/:id

请求参数

路径参数：

参数名称	参数类型	是否必须	备注
id	int	是	存储池Id

返回数据

名称	类型	描述
code	int	状态码（100001表示成功，其它表示异常）
msg	string	状态码描述信息
reason	string	异常时的原因