添加數據目錄
更新時間 2025-09-29 17:49:41
最近更新時間: 2025-09-29 17:49:41
分享文章
本節主要介紹如何使用API添加數據目錄。
此操作用來添加指定服務器的數據目錄至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": {}
}
