此操作用来批量查询存储池。

请求语法

GET /rest/v1/system/storagepool?filter=filter HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Host: ip:port
Authorization: authorization

请求参数

参数	类型	描述	是否必须
filter	String	查询的过滤条件。过滤条件由查询属性和属性值组成，其中属性和属性值之间用单个冒号分隔（key:value）表示模糊匹配，用两个冒号分隔（key::value）表示精确匹配。可以选择多个查询，如果是或的关系，使用“or”将查询条件分隔开；如果是与的关系，使用“and”将查询条件分隔开。支持的过滤条件类型包括： poolName：存储池名称。	否

参数

类型

描述

是否必须

filter

String

查询的过滤条件。

过滤条件由查询属性和属性值组成，其中属性和属性值之间用单个冒号分隔（key:value）表示模糊匹配，用两个冒号分隔（key::value）表示精确匹配。可以选择多个查询，如果是或的关系，使用“or”将查询条件分隔开；如果是与的关系，使用“and”将查询条件分隔开。

支持的过滤条件类型包括：

poolName：存储池名称。

否

响应结果

名称	类型	描述
storagePool	Array of storagePool	存储池信息集合，详见“表1 响应参数storagePool说明”。

表1 响应参数storagePool说明

名称	类型	描述
name	String	存储池名称。
id	Short	存储池序号。
isBasePool	Boolean	是否是基础存储池： true：是基础存储池。 false：不是基础存储池。
status	String	存储池状态： Normal：正常。 Deleting：删除中。
faultDomain	String	存储池故障域级别： path：数据目录级别。 server：服务器级别。 rack：机架级别。 room：机房级别。
description	String	存储池描述信息。
totalCapacity	Long	存储池总容量，单位是bytes。
usedCapacity	Long	存储池已用容量，单位是bytes。
usedCapacityQuota	Long	存储池已用容量配额，单位是bytes。
capacityQuota	Long	存储池容量配额，单位是bytes。
createTime	Long	存储池创建时间。
luns	Object	卷信息，详见“表2 响应参数lun说明”。
topology	Array of topology	存储池拓扑信息集合，详见“表4 响应参数topology/childNode说明”。
qosPolicy	Object	存储池关联的QoS策略信息，详见“表5 响应参数qosPolicy说明”。
qosPolicyforLUN	Object	存储池内卷的默认QoS策略信息，详见“表6 响应参数qosPolicyforLUN说明”。
dataHealth	Object	存储池数据健康信息，详见“表7 响应参数dataHealth说明”。

表2 响应参数lun说明

名称	类型	描述
lunNamesForCachePool	Array of string	缓存存储池卷列表。
lunNamesForPool	Array of string	存储池卷列表。
status	Object	卷的状态信息，详见“表3 响应参数status说明”。

表3 响应参数status说明

名称	类型	描述
number	Integer	存储池关联卷的个数。
cacheNumber	Integer	缓存模式卷的个数。
storageNumber	Integer	存储模式卷的个数。
localNumber	Integer	本地模式卷的个数。
cacheCapacity	Long	缓存模式卷容量，单位是bytes。
storageCapacity	Long	存储模式卷容量，单位是bytes。
localCapacity	Long	本地模式卷容量，单位是bytes。

表4 响应参数topology/childNode说明

名称		类型	描述
name		String	拓扑节点或者子节点名称。
fullname		String	拓扑节点或者子节点的全路径名称。
type		String	拓扑节点或者子节点的类型： room：机房。 rack：机架。 server：服务器。 path：数据目录。
description		String	拓扑节点或子节点的描述信息。如果未添加描述信息，或者节点类型是path，不返回此项。
healthStatus		String	故障域状态： Healthy：健康状态，可正常读写。 Warning：警告状态，可读。 Error：错误状态，无法访问。
childNodes		Array of childNodes	拓扑图中子节点，childNode和topology基本一致，类型不同，包含的内容不同，详见本表其他字段。
如果topology或者childNode的类型是server	clusterAddress	String	拓扑图集群网络IP。
	publicAddress	String	拓扑图业务网络IP。
	allDiskPaths.usedCapacity	Long	拓扑图中所有数据目录的已用容量。
	allDiskPaths.totalCapacity	Long	拓扑图中所有数据目录的总容量。
	serverStatus	String	拓扑图的服务器状态： Connected：已连接。 Disconnected：未连接。 Removing：移除中。
	serverId	String	拓扑图的服务器ID。
	childNodes	Array of childNodes	拓扑图中子节点，childNode和topology基本一致，类型不同，包含的内容不同，详见本表其他字段。
如果topology或者childNode的类型是path	usedCapacity	Long	HBlock数据目录对应分区的已用容量，单位是bytes。
	totalCapacity	Long	HBlock数据目录对应分区的总容量，单位是bytes。
	usedCapacityQuota	Long	数据目录已用容量配额，单位是bytes。
	capacityQuota	Long	数据目录容量配额，单位是bytes。
	managementStatus	String	数据目录的管理状态： Added：已添加。 Removing：正在移除。
	healthStatus	String	数据目录健康状态： Healthy：数据目录处于健康状态，可正常读写，且数据目录所在磁盘使用率未超过阈值（系统默认值为95%）。 Warning：数据目录处于警告状态，可读，但存在以下情况的任意一种：慢盘；数据目录所在磁盘使用率超过阈值（系统默认值为95%）；磁盘剩余空间不足1GiB；HBlock对这个目录停写；数据目录配额使用率超过阈值（系统默认值为95%）；数据目录配额为0。 Error：数据目录错误状态，无法访问，原因可能是：所在磁盘出现I/O错误导致无法读写，数据目录未正确挂载等。
	healthDetail	Array of string	数据目录健康状态详情：如果健康状态为Healthy，不返回此字段。如果健康状态为Warning或Error，显示警告或错误的详细信息。
	serverId	String	数据目录所属的服务器ID。

表5 响应参数qosPolicy说明

名称	类型	描述
qosName	String	存储池关联的QoS策略名称。

表6 响应参数qosPolicyforLUN说明

名称	类型	描述
qosName	String	存储池内卷的默认QoS策略名称。

表7 响应参数dataHealth说明

名称	类型	描述
normal	Double	该存储池所有卷正常数据的百分比。
owRedundancy	Double	该存储池所有卷降级数据的百分比。
error	Double	该存储池所有卷错误数据的百分比。
reconstructionProgress	Double	如果该存储池卷存在降级状态的数据，数据重建进度的百分比。
ETR	Long	如果该存储池卷存在降级数据，预计剩余的数据重建时间。单位为秒。如果返回值为负数，说明数据无法重建，需用户尽快修复。

请求示例

查询存储池中包含pool的存储池。

GET /rest/v1/system/storagepool?filter=poolName:pool HTTP/1.1
Date: Mon, 8 Jun 2026 07:23:51 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443

响应示例

HTTP/1.1 200 OK 
x-hblock-request-id: 82896f22dc5d4204b0533c17ba5a653a
Connection: keep-alive
Content-Length: 4357
Date: Mon, 8 Jun 2026 07:23:51 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock

{
    "data": {
        "storagePool": [
            {
                "name": "default-pool",
                "id": 0,
                "isBasePool": true,
                "status": "Normal",
                "faultDomain": "server",
                "description": "basis storagepool",
                "totalCapacity": 299111325696,
                "usedCapacity": 17531875328,
                "usedCapacityQuota": 0,
                "capacityQuota": 299111325696,
                "createTime": 1780043525119,
                "luns": {
                    "lunNamesForCachePool": [],
                    "lunNamesForPool": [
                        "lun01a",
                        "lun02a"
                    ],
                    "status": {
                        "number": 2,
                        "cacheNumber": 0,
                        "storageNumber": 0,
                        "localNumber": 2,
                        "cacheCapacity": 0,
                        "storageCapacity": 0,
                        "localCapacity": 119185342464
                    }
                },
                "topology": [
                    {
                        "name": "hblock_1",
                        "fullname": "default:hblock_1",
                        "type": "server",
                        "healthStatus": "Healthy",
                        "clusterAddress": "192.168.0.65",
                        "publicAddress": "192.168.0.65",
                        "allDiskPaths": {
                            "usedCapacity": 13058277376,
                            "totalCapacity": 199407550464
                        },
                        "serverStatus": "Connected",
                        "serverId": "hblock_1",
                        "childNodes": [
                            {
                                "name": "/mnt/storage01",
                                "fullname": "default:hblock_1:/mnt/storage01",
                                "type": "path",
                                "usedCapacity": 4618960896,
                                "totalCapacity": 99703775232,
                                "usedCapacityQuota": 0,
                                "capacityQuota": -1,
                                "managementStatus": "Added",
                                "healthStatus": "Healthy",
                                "serverId": "hblock_1"
                            }
                        ]
                    },
                    {
                        "name": "hblock_2",
                        "fullname": "default:room1:hblock_2",
                        "type": "server",
                        "healthStatus": "Healthy",
                        "clusterAddress": "192.168.0.64",
                        "publicAddress": "192.168.0.64",
                        "allDiskPaths": {
                            "usedCapacity": 6665445376,
                            "totalCapacity": 207025528832
                        },
                        "serverStatus": "Connected",
                        "serverId": "hblock_2",
                        "childNodes": [
                            {
                                "name": "/mnt/storage01",
                                "fullname": "default:room1:hblock_2:/mnt/storage01",
                                "type": "path",
                                "usedCapacity": 5882843136,
                                "totalCapacity": 99703775232,
                                "usedCapacityQuota": 0,
                                "capacityQuota": -1,
                                "managementStatus": "Added",
                                "healthStatus": "Healthy",
                                "serverId": "hblock_2"
                            }
                        ]
                    },
                    {
                        "name": "hblock_3",
                        "fullname": "default:room1:rack1:hblock_3",
                        "type": "server",
                        "healthStatus": "Healthy",
                        "clusterAddress": "192.168.0.67",
                        "publicAddress": "192.168.0.67",
                        "allDiskPaths": {
                            "usedCapacity": 7030071296,
                            "totalCapacity": 99703775232
                        },
                        "serverStatus": "Connected",
                        "serverId": "hblock_3",
                        "childNodes": [
                            {
                                "name": "/mnt/storage01",
                                "fullname": "default:room1:rack1:hblock_3:/mnt/storage01",
                                "type": "path",
                                "usedCapacity": 7030071296,
                                "totalCapacity": 99703775232,
                                "usedCapacityQuota": 0,
                                "capacityQuota": -1,
                                "managementStatus": "Added",
                                "healthStatus": "Healthy",
                                "serverId": "hblock_3"
                            }
                        ]
                    }
                ],
                "dataHealth": {
                    "normal": 100,
                    "lowRedundancy": 0,
                    "error": 0
                }
            },
            {
                "name": "pool1",
                "id": 1,
                "isBasePool": false,
                "status": "Normal",
                "faultDomain": "server",
                "totalCapacity": 314347282432,
                "usedCapacity": 10005577728,
                "usedCapacityQuota": 40960,
                "capacityQuota": 314347282432,
                "createTime": 1780901955358,
                "luns": {
                    "lunNamesForCachePool": [
                        "lun02a"
                    ],
                    "lunNamesForPool": [],
                    "status": {
                        "number": 1,
                        "cacheNumber": 0,
                        "storageNumber": 0,
                        "localNumber": 1,
                        "cacheCapacity": 0,
                        "storageCapacity": 0,
                        "localCapacity": 1073741824
                    }
                },
                "topology": [
                    {
                        "name": "hblock_1",
                        "fullname": "default:hblock_1",
                        "type": "server",
                        "healthStatus": "Healthy",
                        "clusterAddress": "192.168.0.65",
                        "publicAddress": "192.168.0.65",
                        "allDiskPaths": {
                            "usedCapacity": 13058277376,
                            "totalCapacity": 199407550464
                        },
                        "serverStatus": "Connected",
                        "serverId": "hblock_1",
                        "childNodes": [
                            {
                                "name": "/mnt/stor01",
                                "fullname": "default:hblock_1:/mnt/stor01",
                                "type": "path",
                                "usedCapacity": 8439316480,
                                "totalCapacity": 99703775232,
                                "usedCapacityQuota": 24576,
                                "capacityQuota": -1,
                                "managementStatus": "Added",
                                "healthStatus": "Healthy",
                                "serverId": "hblock_1"
                            }
                        ]
                    },
                    {
                        "name": "hblock_2",
                        "fullname": "default:room1:hblock_2",
                        "type": "server",
                        "healthStatus": "Healthy",
                        "clusterAddress": "192.168.0.64",
                        "publicAddress": "192.168.0.64",
                        "allDiskPaths": {
                            "usedCapacity": 6665445376,
                            "totalCapacity": 207025528832
                        },
                        "serverStatus": "Connected",
                        "serverId": "hblock_2",
                        "childNodes": [
                            {
                                "name": "/mnt/data1",
                                "fullname": "default:room1:hblock_2:/mnt/data1",
                                "type": "path",
                                "usedCapacity": 782602240,
                                "totalCapacity": 107321753600,
                                "usedCapacityQuota": 8192,
                                "capacityQuota": -1,
                                "managementStatus": "Added",
                                "healthStatus": "Healthy",
                                "serverId": "hblock_2"
                            }
                        ]
                    },
                    {
                        "name": "hblock_4",
                        "fullname": "default:hblock_4",
                        "type": "server",
                        "healthStatus": "Healthy",
                        "clusterAddress": "192.168.0.68",
                        "publicAddress": "192.168.0.68",
                        "allDiskPaths": {
                            "usedCapacity": 783659008,
                            "totalCapacity": 107321753600
                        },
                        "serverStatus": "Connected",
                        "serverId": "hblock_4",
                        "childNodes": [
                            {
                                "name": "/mnt/data1",
                                "fullname": "default:hblock_4:/mnt/data1",
                                "type": "path",
                                "usedCapacity": 783659008,
                                "totalCapacity": 107321753600,
                                "usedCapacityQuota": 8192,
                                "capacityQuota": -1,
                                "managementStatus": "Added",
                                "healthStatus": "Healthy",
                                "serverId": "hblock_4"
                            }
                        ]
                    }
                ],
                "dataHealth": {
                    "normal": 100,
                    "lowRedundancy": 0,
                    "error": 0
                }
            }
        ]
    }
}

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

存储资源盘活系统

存储资源盘活系统

请求语法

请求参数

响应结果

请求示例

响应示例

活动

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

存储资源盘活系统

存储资源盘活系统

请求语法

请求参数

响应结果

请求示例

响应示例