-
响应示例 返回状态码为200：修改成功。 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" : {
"stpMode" : 1,
"mstpRegions" : [
{
"regionId" : "fbb684c8-0d37-496f-bafa-4b06e5151e2e",
"regionName" : "stp_region",
"revisionLevel" : 0,
"mstpRegionInstances" : [
{
"instanceId" : 0,
"mapVlan" : "1,3-10",
"regionInstanceDevices" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"priority" : 15
}
]
}
],
"regionDeviceList" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"deviceName" : "LSW"
}
]
}
],
"rstpConfig" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"priority" : 15
}
]
}
}
-
请求示例 HTTP的示例 PUT /controller/campus/v1/networkservice/networkconfig/net/lswstp/sites/fbb684c8-0d37-496f-bafa-4b06db151e2e/stp 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
{
"stpMode" : 1,
"mstpRegions" : [
{
"regionId" : "fbb684c8-0d37-496f-bafa-4b06e5151e2e",
"regionName" : "stp_region",
"revisionLevel" : 0,
"mstpRegionInstances" : [
{
"instanceId" : 0,
"mapVlan" : "1,3-10",
"regionInstanceDevices" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"priority" : 15
}
]
}
],
"regionDeviceList" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"deviceName" : "LSW"
}
]
}
],
"rstpConfig" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"priority" : 15
}
]
}
-
请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表3。 站点内交换机的STP配置参数体。 - 表3 StpDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 stpMode 是 integer [1-2] - STP模式。1表示MSTP，2表示RSTP。 1 mstpRegions 否 ARRAY_REFERENCE 1-8个列表项，详细请参见表4。 MST域集合。MSTP模式下需要配置。 - rstpConfig 否 ARRAY_REFERENCE 1-8个列表项，详细请参见表7。 RSTP优先级。RSTP模式下需要配置。 - 表4 MstpRegion对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 regionId 否 string - - 域ID，UUID格式。创建时自动生成。 "fbb684c8-0d37-496f-bafa-4b06e5151e2e" regionName 是 string 1~32个字符。 -
域名 。 "stp_region" revisionLevel 是 int64 [0-65535] - 修订级别。 0 mstpRegionInstances 是 ARRAY_REFERENCE 1-16个列表项，详细请参见表5。 生成树实例集合。 - regionDeviceList 否 ARRAY_REFERENCE 1-16个列表项，详细请参见表6。 设备ID实例集合。 - 表5 MstpRegionInstance对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 instanceId 是 integer [0-4094] - 生成树实例ID。 0 mapVlan 否 string 1~100个字符。 - 映射VLAN，instancdId不为0的生成树才生效。 "1,3-10" regionInstanceDevices 是 ARRAY_REFERENCE 1-100个列表项，详细请参见表7。 生成树实例下设备集合。 - 表6 RegionDeviceList对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 string - - 设备ID，字符串格式为UUID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" deviceName 是 string - - 设备Name。 "LSW" 表7 RegionInstanceDevice对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 是 string - - 设备ID，字符串格式为UUID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" priority 否 integer [0-15] - 设备优先级。 15
-
响应示例 返回状态码为200：查询成功。 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" : {
"stpMode" : 1,
"mstpRegions" : [
{
"regionId" : "fbb684c8-0d37-496f-bafa-4b06e5151e2e",
"regionName" : "stp_region",
"revisionLevel" : 0,
"mstpRegionInstances" : [
{
"instanceId" : 0,
"mapVlan" : "1,3-10",
"regionInstanceDevices" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"priority" : 15
}
]
}
],
"regionDeviceList" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"deviceName" : "LSW"
}
]
}
],
"rstpConfig" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"priority" : 15
}
]
}
}
-
响应参数 返回状态码为200：查询成功。 表2 StpResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data REFERENCE 详细请参见表3。 - - 表3 StpDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 stpMode integer [1-2] - STP模式。1表示MSTP，2表示RSTP。 1 mstpRegions ARRAY_REFERENCE 1-8个列表项，详细请参见表4。 MST域集合。MSTP模式下需要配置。 - rstpConfig ARRAY_REFERENCE 1-8个列表项，详细请参见表7。 RSTP优先级。RSTP模式下需要配置。 - 表4 MstpRegion对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 regionId string - - 域ID，UUID格式。创建时自动生成。 "fbb684c8-0d37-496f-bafa-4b06e5151e2e" regionName string 1~32个字符。 - 域名。 "stp_region" revisionLevel int64 [0-65535] - 修订级别。 0 mstpRegionInstances ARRAY_REFERENCE 1-16个列表项，详细请参见表5。 生成树实例集合。 - regionDeviceList ARRAY_REFERENCE 1-16个列表项，详细请参见表6。 设备ID实例集合。 - 表5 MstpRegionInstance对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 instanceId integer [0-4094] - 生成树实例ID。 0 mapVlan string 1~100个字符。 - 映射VLAN，instancdId不为0的生成树才生效。 "1,3-10" regionInstanceDevices ARRAY_REFERENCE 1-100个列表项，详细请参见表7。 生成树实例下设备集合。 - 表6 RegionDeviceList对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string - - 设备ID，字符串格式为UUID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" deviceName string - - 设备Name。 "LSW" 表7 RegionInstanceDevice对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string - - 设备ID，字符串格式为UUID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" priority integer [0-15] - 设备优先级。 15
-
请求示例 HTTP的示例 GET /controller/campus/v1/networkservice/networkconfig/net/lswstp/sites/fbb684c8-0d37-496f-bafa-4b06db151e2e/stp 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
-
响应示例 返回状态码为200：删除成功。 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" : {
"stpMode" : 1,
"mstpRegions" : [
{
"regionId" : "fbb684c8-0d37-496f-bafa-4b06e5151e2e",
"regionName" : "stp_region",
"revisionLevel" : 0,
"mstpRegionInstances" : [
{
"instanceId" : 0,
"mapVlan" : "1,3-10",
"regionInstanceDevices" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"priority" : 15
}
]
}
],
"regionDeviceList" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"deviceName" : "LSW"
}
]
}
],
"rstpConfig" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"priority" : 15
}
]
}
}
-
请求示例 HTTP的示例 POST /controller/campus/v1/networkservice/networkconfig/net/lswstp/sites/fbb684c8-0d37-496f-bafa-4b06db151e2e/action/batch-delete 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
{
"mstpRegions" : [
{
"regionId" : "fbb684c8-0d37-496f-bafa-4b06e5151e2e",
"mstpRegionInstances" : [
{
"instanceId" : 1,
"regionInstanceDevices" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e"
}
]
}
],
"regionDeviceList" : [
""
]
}
]
}
-
典型场景 提供配置参数的接口，删除交换机MSTP配置。 1、若只传入regionId，删除对应的MSTPregion； 2、若只传入regionId和instanceId，则删除指定regionId下的instanceId对应的mstpRegionInstance； 3、若只传入regionId和deviceId，则删除指定regionId下的regionDeviceList中的deviceId，且会删除指定regionID下，所有instance下的deviceId对应的regionInstanceDevice； 4、若传入regionId、instanceId和deviceId，只删除指定regionId下指定instanceId下的regionInstanceDevice，instanceId为0的树无法删除。
-
URI /controller/campus/v1/networkservice/networkconfig/net/lswstp/sites/{siteId}/action/batch-delete 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 uuid - - 站点ID。 "fbb684c8-0d37-496f-bafa-4b06db151e2e"
-
响应示例 返回状态码为200：修改成功。 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" : {
"stpMode" : 1,
"mstpRegions" : [
{
"regionId" : "fbb684c8-0d37-496f-bafa-4b06e5151e2e",
"regionName" : "stp_region",
"revisionLevel" : 0,
"mstpRegionInstances" : [
{
"instanceId" : 0,
"mapVlan" : "1,3-10",
"regionInstanceDevices" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"priority" : 15
}
]
}
],
"regionDeviceList" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"deviceName" : "LSW"
}
]
}
],
"rstpConfig" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"priority" : 15
}
]
}
}
-
请求示例 HTTP的示例 PUT /controller/campus/v1/networkservice/networkconfig/net/lswstp/sites/fbb684c8-0d37-496f-bafa-4b06db151e2e/stp-increment 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
{
"mstpRegions" : [
{
"regionId" : "fbb684c8-0d37-496f-bafa-4b06e5151e2e",
"regionName" : "stp_region",
"revisionLevel" : 0,
"mstpRegionInstances" : [
{
"instanceId" : 0,
"mapVlan" : "1,3-10",
"regionInstanceDevices" : [
{
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e",
"priority" : 15
}
]
}
],
"regionDeviceList" : [
""
]
}
]
}
