此操作用来添加指定服务器的数据目录至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
要添加的数据目录所属服务器ID。
类型：字符串
是
diskPaths
数据目录属性集合。包括path、capacityQuota。
类型：数组
是
path
指定添加的数据目录。数据目录用于存储数据，建议不要与操作系统共用磁盘或文件系统。
注意
数据目录中不能有逗号（,）。
类型：字符串列表
是
capacityQuota
指定数据目录的容量配额，即针对加入到服务器中的每个数据目录，HBlock可写入的数据总量。当HBlock的使用空间一旦达到配额，就立刻阻止数据写入，不允许再使用超出配额的空间。
类型：长整型
取值：小于数据目录所在磁盘的总容量，单位是字节。负整数表示无限制写入，0表示禁止写入。默认不限制写入。
注意
如果相同的数据目录出现多次，以第一次出现的数据目录的容量配额为准。
否

请求示例

添加服务器hblock_2的数据目录。

POST /rest/v1/system/server/hblock_2/diskpaths HTTP/1.1
Date: Wed, 27 Sep 2023 05: 51: 20 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 137
Host: 192.168.0.117: 1443 

{
    "diskPaths": [
        {
            "path": "/mnt/storage01",
            "capacityQuota": 1024000000
        },
        {
            "path": "/mnt/storage02"
        }
    ]
}

响应示例

HTTP/1.1 200 OK 
x-hblock-request-id: f0ec3fbbf3154cc99a671c3be437852a
Connection: keep-alive
Date: Wed, 27 Sep 2023 05:51:20 GMT
Content-Length: 0
Server: HBlock