此操作用来修改拓扑节点信息。
注意
不支持修改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