此操作用来创建拓扑节点。

请求语法

POST /rest/v1/system/topology HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization

{
    "nodeName": nodeName,
    "nodeType": nodeType,
    "description": description,
    "parentName": nodeName
}

请求参数

参数
描述
是否必须
nodeName
拓扑节点名称。
类型：字符串
取值：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（_）和短横线(-)组成，字母区分大小写，且仅支持以字母或数字开头。
是
nodeType
拓扑节点的类型。
类型：枚举
取值：
rack：机架类型。
room：机房类型。
是
description
节点描述信息。
类型：字符串
取值：1~50位字符串。
否
parentName
父节点名称。
类型：字符串
取值：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（_）和短横线(-)组成，字母区分大小写，且仅支持以字母或数字开头。默认为根节点。
否

请求示例

创建节点rack3。

POST /rest/v1/system/topology HTTP/1.1
Date: Mon, 24 Jun 2024 09: 34: 29 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 119
Host: 192.168.0.110: 1443 

{
    "nodeName": "rack3",
    "nodeType": "rack",
    "description": "The new rack.",
    "parentName": "room-3"
}

响应示例

HTTP/1.1 200 OK 
x-hblock-request-id: e59fb36c5d3e4a72a93d8eb8caa3ee7e
Connection: keep-alive
Content-Length: 0
Date: Mon, 24 Jun 2024 09:34:29 GMT
Server: HBlock