-
请求示例 HTTP的示例 POST /controller/campus/baseservice/api/v1/device/stack/action/batch-delete HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-AC
CES S-TOKEN: x-yyyyyy
{
"stackIds" : ["d25de9be-1d9a-4d06-a519-09ff92fee050","d25de9be-1d9a-4d06-a519-09ff92fee050"]
}
-
响应示例 返回状态码为200：删除堆叠成功，响应体参考DeleteStackOut。 返回状态码为400：校验异常，无响应体 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500：内部服务错误，无响应体 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
响应示例 返回状态码为200：调用查询堆叠成功，响应体参考QueryStackIdsOutDtoData。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "",
"data" : [
{
"deviceId" : "as25fdbf-8dee-4823-bac2-5bfe8e3359cb",
"stackId" : "as25fdbf-8dee-4823-bac2-5bfe8e3359ca"
}
]
} 返回状态码为400：调用查询堆叠接口入参非法，无响应体。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500：调用查询堆叠内部异常，无响应体。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
响应参数 返回状态码为200：调用查询堆叠成功，响应体参考QueryStackIdsOutDtoData。 表3 QueryStackIdsOutDtoData对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。当没有错误时返回0。 "0" errmsg string - - 错误信息。 "" data ARRAY_REFERENCE 0-1000个列表项，详细请参见表4。 设备ID和堆叠ID对应列表。 - 表4 StackIdsOutDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string 1~64个字符。 - 设备ID，UUID格式。 "as25fdbf-8dee-4823-bac2-5bfe8e3359cb" stackId string 0~64个字符。 - 堆叠ID，UUID格式。 "as25fdbf-8dee-4823-bac2-5bfe8e3359ca" 返回状态码为400：调用查询堆叠接口入参非法，无响应体。 详细信息请参见实际响应消息体。 返回状态码为500：调用查询堆叠内部异常，无响应体。 详细信息请参见实际响应消息体。
-
请求示例 HTTP的示例 POST /controller/campus/v3/stack/ids/list HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
{
"deviceIdList" : ["as25fdbf-8dee-4823-bac2-5bfe8e3359ca","as25fdbf-8dee-4823-bac2-5bfe8e3359cb"]
}
-
响应示例 返回状态码为200：移除堆叠成员成功，响应体参考DeleteStackMemberOut。 返回状态码为400：校验异常，无响应体 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500：内部服务错误，无响应体 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
请求示例 HTTP的示例 POST /controller/campus/baseservice/api/v1/device/stack/member/action/batch-delete?stackId=d25de9be-1d9a-4d06-a519-09ff92fee050 HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
{
"memberIds" : ["d25de9be-1d9a-4d06-a519-09ff92fee050","d25de9be-1d9a-4d06-a519-09ff92fee050"]
}
-
响应示例 返回状态码为200：调用创建堆叠成功，响应体参考CreateStackOutDto。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "",
"success" : [
{
"stackId" : "as25fdbf-8dee-4823-bac2-5bfe8e3359ca",
"stackName" : "stack1",
"stackMember" : [
{
"errcode" : "0",
"errmsg" : "",
"deviceId" : "as25fdbf-8dee-4823-bac2-5bfe8e3359ca",
"esn" : "AP5008293500000001",
"stackMemberId" : "as25fdbf-8dee-4823-bac2-5bfe8e3359xa",
"slotId" : 0,
"priority" : 100
}
]
}
],
"fail" : [
{
"stackName" : "site1",
"stackMember" : [
{
"errcode" : "0",
"errmsg" : "",
"deviceId" : "as25fdbf-8dee-4823-bac2-5bfe8e3359ca",
"esn" : "AP5008293500000001",
"stackMemberId" : "as25fdbf-8dee-4823-bac2-5bfe8e3359xa",
"slotId" : 0,
"priority" : 100
}
]
}
]
}
-
响应参数 返回状态码为200：调用创建堆叠成功，响应体参考CreateStackOutDto。 表5 CreateStackOutDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。当没有错误时返回0。 "0" errmsg string - - 错误信息。 "" success ARRAY_REFERENCE 0-100个列表项，详细请参见表6。 成功的堆叠设备列表。 - fail ARRAY_REFERENCE 0-100个列表项，详细请参见表8。 失败的堆叠设备列表。 - 表6 createStackSuccess对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 stackId string 1~64个字符。 - 堆叠ID，UUID格式。 "as25fdbf-8dee-4823-bac2-5bfe8e3359ca" stackName string 1~64个字符。 - 堆叠名称。 该字段对应UI页面上是：UI【堆叠名称】 "stack1" stackMember ARRAY_REFERENCE 1-9个列表项，详细请参见表7。 堆叠成员。 - 表7 StackMemberOutput对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" deviceId string - - 设备ID，UUID格式。 "as25fdbf-8dee-4823-bac2-5bfe8e3359ca" esn string - - 设备ESN。 该字段对应UI页面上是：UI【ESN】 "AP5008293500000001" stackMemberId string - - 堆叠成员ID，UUID格式。 "as25fdbf-8dee-4823-bac2-5bfe8e3359xa" slotId int32 - - 设备堆叠编号。 该字段对应UI页面上是：UI【槽位号】 0 priority int32 - - 设备堆叠优先级。 该字段对应UI页面上是：UI【优先级】 100 表8 createStackFail对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 stackName string 1~64个字符。 - 堆叠名称。 该字段对应UI页面上是：UI【堆叠名称】 "site1" stackMember ARRAY_REFERENCE 1-9个列表项，详细请参见表7。 堆叠成员 -
-
请求示例 HTTP的示例 POST /controller/campus/v3/stack HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
{
"stacks" : [
{
"stackName" : "stack1",
"stackMember" : [
{
"esn" : "AP5008293500000001",
"slotId" : 0,
"priority" : 100
}
],
"stackRoles" : "ACC"
}
]
}
-
请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 createStackDto 是 REFERENCE 详细请参见表2。 创建堆叠入参。 - 表2 CreateStackDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 stacks 是 ARRAY_REFERENCE 0-100个列表项，详细请参见表3。 堆叠信息。 - 表3 CreateStackDtoData对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 stackName 是 string 1~64个字符。 - 堆叠名称。如果堆叠名称已存在，则将设备加入堆叠；否则，创建堆叠并加入设备。堆叠名称不能包含"?"或者制表符TAB。 该字段对应UI页面上是：UI【堆叠名称】 "stack1" stackMember 是 ARRAY_REFERENCE 1-9个列表项，详细请参见表4。 堆叠成员。 - stackRoles 否 string Gateway CORE Gateway+CORE Gateway+RR Firewall WAC AGG ACC Wireless Access TG ACC 堆叠角色信息。非必填，默认为ACC。 该字段对应UI页面上是：UI【堆叠角色】 "ACC" 表4 StackMemberInput对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 esn 是 string 10~64个字符。 - 设备ESN。 该字段对应UI页面上是：UI【ESN】 "AP5008293500000001" slotId 否 int32 [0-9] - 堆叠成员编号。(添加盒式堆叠成员时非必填，添加框式堆叠成员时必填)。 该字段对应UI页面上是：UI【槽位号】 0 priority 否 int32 [1-255] 100 堆叠成员优先级。 该字段对应UI页面上是：UI【优先级】 100
