此操作用来创建存储池。
说明
HBlock集群中最多可以创建32768个存储池。
请求语法
POST /rest/v1/system/storagepool HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization
{
"poolName": poolName,
"faultDomain": faultDomain,
"description": description,
"qosPolicy": {
"qosName": qosName,
"IOPS": IPOS,
"readIOPS": readIOPS,
"writeIOPS": writeIOPS,
"Bps": Bps,
"readBps": readBps,
"writeBps": writeBps,
"IOPSBurst": IOPSBurst,
"readIOPSBurst": readIOPSBurst,
"writeIOPSBurst": writeIOPSBurst,
"BpsBurst": BpsBurst,
"readBpsBurst": readBpsBurst,
"writeBpsBurst": writeBpsBurst,
"IOPSBurstSecs": IOPSBurstSecs,
"readIOPSBurstSecs": readIOPSBurstSecs,
"writeIOPSBurstSecs": writeIOPSBurstSecs,
"BpsBurstSecs": BpsBurstSecs,
"readBpsBurstSecs": readBpsBurstSecs,
"writeBpsBurstSecs": writeBpsBurstSecs
}
}请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| poolName | String | 存储池名称。 取值：长度范围是1~16，只能由字母、数字和短横线（-）、下划线（_）组成，字母区分大小写，且仅支持以字母和数字开头。 | 是 |
| faultDomain | String | 指定存储池的故障域级别。 取值：
默认值为server。 | 否 |
| description | String | 存储池的描述信息。 取值：1~50位字符串。 | 否 |
| qosPolicy | Object | 卷关联的QoS策略信息，详见“表1 请求参数config.qosPolicy说明”。 | 否 |
表1 请求参数config.qosPolicy说明
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| qosName | String | 指定QoS策略名称。 说明 创存储池时，如果指定QoS策略名称不存在，那么同时创建QoS策略，新创建的QoS策略的回收策略默认为Delete。 取值：长度范围1~64，只能由字母、数字和短横线(-)组成，区分大小写，且仅支持以字母或数字开头。 注意
| 是 |
| IOPS | Long | 每秒能够进行读写操作次数的最大值。 取值：取值范围为[-1, 999999999]，默认值为-1。-1表示不限制。 | 否 |
| readIOPS | Long | 每秒能够进行读操作次数的最大值。 取值：取值范围为[-1, 999999999]，默认值为-1。-1表示不限制。 | 否 |
| writeIOPS | Long | 每秒能够进行写操作次数的最大值。 取值：取值范围为[-1, 999999999]，默认值为-1。-1表示不限制。 | 否 |
| Bps | Long | 每秒可传输数据量的最大值。 取值：取值范围为[-1, 4096000000000]，默认值为-1，单位是Bytes/s。-1表示不限制。 | 否 |
| readBps | Long | 读带宽上限。 取值：取值范围为[-1, 4096000000000]，默认值为-1，单位是Bytes/s。-1表示不限制。 | 否 |
| writeBps | Long | 写带宽上限。 取值：取值范围为[-1, 4096000000000]，默认值为-1，单位是Bytes/s。-1表示不限制。 | 否 |
| IOPSBurst | Long | 使用Burst功能时，每秒能够进行读写操作次数的最大值。 取值：只有当IOPS大于等于1时，此项设置为-1或(IOPS, 999999999]内的正整数方可生效。默认值为-1，表示不限制。 | 否 |
| readIOPSBurst | Long | 使用Burst功能时，每秒能够进行读操作次数的最大值。 取值：只有当readIOPS大于等于1时，此项设置为-1或(readIOPS, 999999999]内的正整数方可生效。默认值为-1，表示不限制。 | 否 |
| writeIOPSBurst | Long | 使用Burst功能时，每秒能够进行写操作次数的最大值。 取值：只有当writeIOPS大于等于1时，此项设置为-1或(writeIOPS, 999999999]内的正整数方可生效。默认值为-1，表示不限制。 | 否 |
| BpsBurst | Long | 使用Burst功能时，每秒可传输的数据量最大值。 取值：只有当Bps大于等于1时，此项设置为-1或(Bps, 4096000000000]内的正整数方可生效，默认值为-1，单位是Bytes/s。-1表示不限制。 | 否 |
| readBpsBurst | Long | 使用Burst功能时，读带宽上限。 取值：只有当readBps大于等于1时，此项设置为-1或(readBps, 4096000000000]内的正整数方可生效，默认值为-1，单位是Bytes/s。-1表示不限制。 | 否 |
| writeBpsBurst | Long | 使用Burst功能时，写带宽上限。 取值：只有当writeBps大于等于1时，此项设置为-1或(writeBps, 4096000000000]内的正整数方可生效，默认值为-1，单位是Bytes/s。-1表示不限制。 | 否 |
| IOPSBurstSecs | Long | 使用Burst功能时，按照Burst上限的能力进行读写操作所能持续的时间。 注意 只有在IOPS Burst功能启用时，此配置才生效。 取值：取值范围为[1, 999999999]，默认值为1，单位是秒。 | 否 |
| readIOPSBurstSecs | Long | 使用Burst功能时，按照Burst上限的能力进行读操作所能持续的时间。 注意 只有在read IOPS Burst功能启用时，此配置才生效。 取值：取值范围为[1, 999999999]，默认值为1，单位是秒。 | 否 |
| writeIOPSBurstSecs | Long | 使用Burst功能时，按照Burst上限的能力进行写操作所能持续的时间。 注意 只有在write IOPS Burst功能启用时，此配置才生效。 取值：取值范围为[1, 999999999]，默认值为1，单位是秒。 | 否 |
| BpsBurstSecs | Long | 使用Burst功能时，按照Burst上限的流量能力所能持续的时间。 注意 只有在Bps Burst功能启用时，此配置才生效。 取值：取值范围为[1, 999999999]，默认值为1，单位是秒。 | 否 |
| readBpsBurstSecs | Long | 使用Burst功能时，按照Burst上限的读流量能力所能持续的时间，单位是秒。 注意 只有在read Bps Burst功能启用时，此配置才生效。 取值：取值范围为[1, 999999999]，默认值为1，单位是秒。 | 否 |
| writeBpsBurstSecs | Long | 使用Burst功能时，按照Burst上限的写流量能力所能持续的时间。 注意 只有在write Bps Burst功能启用时，此配置才生效。 取值：取值范围为[1, 999999999]，默认值为1，单位是秒。 | 否 |
请求示例
创建存储池pool4。
POST /rest/v1/system/storagepool HTTP/1.1
Date: Thu, 21 Aug 2025 01:53:15 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 159
Host: 192.168.0.65:1443
{
"poolName": "pool4",
"faultDomain": "path",
"description": "The pool is path level.",
"qosPolicy": {
"qosName": "QoS6"
}
}响应示例
HTTP/1.1 200 OK
x-hblock-request-id: 2a6ccdba8d284dbd8d8aa7aaadc3f050
Connection: keep-alive
Content-Length: 0
Date: Thu, 21 Aug 2025 01:53:15 GMT
Server: HBlock
