此操作用来添加指定服务器的数据目录至HBlock。一次可以添加多个数据目录。
说明
对于新增的数据目录,建议设置开机自动挂载,或使用已设置自动挂载的目录或子目录。
注意
每台服务器最多只能添加100个数据目录。
请求语法
POST /rest/v1/system/server/serverId/diskpaths HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization
{
"diskPaths": [
{
"path":path,
"capacityQuota": capacityvalue
},
{
"path":path,
"capacityQuota": capacityvalue
},
……
]
}
请求参数
参数 | 类型 | 描述 | 是否必须 |
---|---|---|---|
serverId | String | 要添加的数据目录所属服务器ID。 | 是 |
diskPaths | Array of diskPath | 数据目录属性集合,详见“表1 请求参数diskPath说明”。 | 是 |
表1 请求参数diskPath说明
参数 | 类型 | 描述 | 是否必须 |
---|---|---|---|
path | String | 指定添加的数据目录。数据目录用于存储数据,建议不要与操作系统共用磁盘或文件系统。 注意 数据目录中不能有逗号(,)。 | 是 |
capacityQuota | Long | 指定数据目录的容量配额,即针对加入到服务器中的每个数据目录,HBlock可写入的数据总量。当HBlock的使用空间一旦达到配额,就立刻阻止数据写入,不允许再使用超出配额的空间。 取值:小于数据目录所在磁盘的总容量,单位是字节。负整数表示无限制写入,0表示禁止写入。默认不限制写入。 注意 如果相同的数据目录出现多次,以第一次出现的数据目录的容量配额为准。 | 否 |
请求示例
添加服务器hblock_1的数据目录。
POST /rest/v1/system/server/hblock_1/diskpaths HTTP/1.1
Date: Mon, 7 Apr 2025 08:24:32 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 134
Host: 192.168.0.65:1443
{
"diskPaths":[
{ "path": "/mnt/storage01",
"capacityQuota": 1024000
},
{ "path": "/mnt/storage02"}
]
}
响应示例
HTTP/1.1 200 OK
x-hblock-request-id: 18243552b8744a2990f33ff8d2d37bd7
Connection: keep-alive
Date: Mon, 7 Apr 2025 08:24:32 GMT
Content-Length: 11
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {}
}