云服务器内容精选

  • 请求示例 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-AC CES S-TOKEN: x-yyyyyy { "mstpRegions" : [ { "regionId" : "fbb684c8-0d37-496f-bafa-4b06e5151e2e", "mstpRegionInstances" : [ { "instanceId" : 1, "regionInstanceDevices" : [ { "deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e" } ] } ], "regionDeviceList" : [ "" ] } ] }
  • 响应示例 返回状态码为200:删除成功。 HTTP/1.1 200 OK Date: Sun,16 Feb 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 } ] } }
  • 典型场景 提供配置参数的接口,删除交换机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"
  • 请求示例 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-ACCESS-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 } ] }
  • 响应示例 返回状态码为200:修改成功。 HTTP/1.1 200 OK Date: Sun,16 Feb 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 } ] } }
  • 请求参数 表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,16 Feb 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" : [ "" ] } ] }
  • 响应示例 返回状态码为200:查询成功。 HTTP/1.1 200 OK Date: Sun,16 Feb 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