此操作用来修改拓扑节点信息。

注意
不支持修改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
拓扑节点名称。
类型：字符串
取值：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（_）和短横线(-)组成，字母区分大小写，且仅支持以字母或数字开头。
是
newName
拓扑节点的新名称。
类型：字符串
取值：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（_）和短横线(-)组成，字母区分大小写，且仅支持以字母或数字开头。
否
description
节点描述信息。
类型：字符串
取值：1~50位字符串。
否
parentName
父节点名称。
类型：字符串
取值：字符串形式，长度范围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