查询虚拟组织节点的子节点
更新时间:2022-02-17
接口描述
本接口用于查询虚拟组织的节点的子节点列表。
请求(Request)
请求URI
GET /v1/virtualOrgNode?listChildren&parentNodeId={parentNodeId}&marker={marker}&maxSize={maxSize}&name={name}
请求头域
除公共头域外,无其它特殊头域。
请求体
参数名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
parentNodeId | Long | 是 | 父节点ID |
marker | Long | 否 | 本次查询的起始游标, 可以从返回的nextMarker中获取 |
maxSize | Integer | 是 | 本次查询的最大结果数, 支持1-100 |
name | String | 否 | 节点名称, 支持前缀匹配 |
响应(Response)
响应头域
除公共头域外,无其它特殊头域。
响应体
参数名称 | 类型 | 描述 |
---|---|---|
marker | Long | 本次查询的起点 |
nextMarker | Long | 下一次查询的起点, 为空表示已经返回所有结果 |
truncated | Boolean | 指明是否所有查询都返回了, false-本次已经返回所有结果, true-本次还没有返回所有结果 |
data | Array | 结果列表 |
+ nodeId | Long | 节点ID |
+ name | String | 节点名称 |
+ gbId | String | 节点国标ID |
+ parentNodeId | Long | 父节点ID |
+ deviceId | Long | 挂载的设备ID |
示例
请求示例
GET /v1/virtualOrgNode?listChildren&parentNodeId=1000001&marker=1000002&maxSize=5 HTTP/1.1
x-bce-date: 2020-03-25T09:28:13Z
host: evs.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2020-03-25T09:28:13Z/1800/content-type;hostx-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715
响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 202 013:34:07 GMT
Content-Type: application/json;charset=UTF-8
{
"marker": 1000002,
"truncated": false,
"data": [
{
"nodeId": 1000003,
"name": "北京市海淀区公安分局",
"gbId": "42060000492001000003",
"parentNodeId": 1000001,
},
{
"nodeId": 1000004,
"name": "北京市海淀区公安分局",
"gbId": "42060000492001000004",
"parentNodeId": 1000001,
"deviceId": 1000005
}
]
}
错误码
参考公共错误码。