修改拓撲節點信息
更新時間 2025-04-23 15:02:49
最近更新時間: 2025-04-23 15:02:49
分享文章
本節主要介紹如何使用API 修改拓撲節點信息。
此操作用來修改拓撲節點信息。
注意
不支持修改path級別的節點信息。
請求語法
PUT /rest/v1/system/topology/nodeName HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization
{
"newName": nodeName,
"description": description,
"parentName": nodeName
}請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| nodeName | String | 拓撲節點名稱。 取值：字符串形式，長度范圍1~63，只能由字母、數字、句點(.)、下劃線（_）和短橫線(-)組成，字母區分大小寫，且僅支持以字母或數字開頭。 | 是 |
| newName | String | 拓撲節點的新名稱。 取值：字符串形式，長度范圍1~63，只能由字母、數字、句點(.)、下劃線（_）和短橫線(-)組成，字母區分大小寫，且僅支持以字母或數字開頭。 | 否 |
| description | String | 節點描述信息。 取值：1~50位字符串。 | 否 |
| parentName | String | 父節點名稱。 取值：字符串形式，長度范圍1~63，只能由字母、數字、句點(.)、下劃線（_）和短橫線(-)組成，字母區分大小寫，且僅支持以字母或數字開頭。 默認為根節點。 | 否 |
請求示例
修改節點rack3。
PUT /rest/v1/system/topology/rack3 HTTP/1.1
Date: Mon, 24 Jun 2024 10: 10: 38 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 94
Host: 192.168.0.110: 1443
{
"newName": "rack-3",
"description": "The new rack.",
"parentName": "room-3"
}響應示例
HTTP/1.1 204 No Content
x-hblock-request-id: 9182545a7fb2455da83cebb3177cf8a0
Connection: keep-alive
Date: Mon, 24 Jun 2024 10:10:38 GMT
Server: HBlock
