-
响应示例 返回状态码为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" : {
"pageIndex" : 1,
"pageSize" : 20,
"totalRecords" : 100,
"deviceConfigDtos" : [
{
"deviceId" : "d623ead6-a2cc-4c3c-9039-dcc8fa898a60",
"siteId" : "d623ead6-a2cc-4c3c-9039-dcc8fa898a60",
"siteName" : "S6720",
"tenantId" : "ea25fdbf-8dee-4823-bac2-5bfe8e335901",
"esn" : "21500102390000009990",
"deviceName" : "",
"deviceStatus" : "0",
"configStatus" : "0",
"deviceType" : "LSW",
"supportFeature" : "true",
"retry" : "true"
}
]
}
}
-
请求示例 HTTP的示例 GET /controller/campus/v1/networkconfigservice/configresult/statics?filter=pageIndex::1%7CpageSize::20%7Cstatus::0,1,2,3,4%7CsiteName::S6720%7CerrMsg::设备当前款型或版本不支持该功能。 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
-
响应参数 返回状态码为200:查询配置结果统计信息成功。 表2 AllSiteResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~100个字符。 - 错误码。 "0" errmsg string 0~100个字符。 - 错误信息。 "" data REFERENCE 详细请参见表3。 配置结果统计信息。 - 表3 ConfigStateDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 pageIndex int32 [1-65535] - 当前页。 1 pageSize int32 [10-300] - 每页记录数,默认为20。 20 totalRecords int64 [0-400000] - 总记录数量。 100 deviceConfigDtos ARRAY_REFERENCE 详细请参见表4。 所有设备配置结果集合 - 表4 DeviceConfigDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string 36个字符。 - 设备ID。 "d623ead6-a2cc-4c3c-9039-dcc8fa898a60" siteId string 36个字符。 - 站点ID。 "d623ead6-a2cc-4c3c-9039-dcc8fa898a60" siteName string 0~64个字符。 - 站点名称。 "S6720" tenantId string 32~36个字符。 - 租户ID。 "ea25fdbf-8dee-4823-bac2-5bfe8e335901" esn string 8~64个字符。 - 设备ESN号。 "21500102390000009990" deviceName string 0~64个字符。 - 设备名称 - deviceStatus int32 [0-4] 0 1 2 3 4 - 设备状态 0: 正常 1: 告警 2: 故障 3: 离线 4: 未注册 "0" configStatus int32 [0-4] 0 1 2 3 4 - 配置状态 0: 成功 1: 告警 2: 预配置 3: 失败 4: 正在下发 "0" deviceType string 0~128个字符。 - 设备类型。 "LSW" supportFeature boolean true false - 是否有不支持下发的特性; true:有,false:无。 "true" retry boolean true false - 是否允许重下发。 "true"
-
URI /controller/campus/v1/networkconfigservice/configresult/statics 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 filter 否 string 0~1024个字符。 - 查询过滤条件。pageIndex::1|pageSize::20|status::0,1,2,3,4|siteName::S6720|errMsg::设备当前款型或版本不支持该功能。 status:配置状态,以英文逗号分隔 0-成功,1-提示,2-预配置,3-失败,4-正在部署;默认 0,1,2,3,4(全部)。 pageIndex:页码,默认1。 pageSize:每页条目数,最大值300,最小10,默认20。 siteName:站点名称,默认空,返回所有站点的统计信息。 errMsg:错误信息,默认空。 备注:默认指的是不传filter,或者是filter内无该查询条件;‘|’要使用‘%7C’转义符。 "pageIndex::1%7CpageSize::20%7Cstatus::0,1,2,3,4%7CsiteName::S6720%7CerrMsg::设备当前款型或版本不支持该功能。"
-
响应示例 返回状态码为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" : [
{
"deviceId" : "d623ead6-a2cc-4c3c-9039-dcc8fa898a60",
"esn" : "AA50082935AAAC003037",
"configStates" : [
{
"featureIdentify" : "initloginuser",
"state" : 0,
"featureItems" : [
{
"id" : "7b4b8bedffdc416ab97c406fdbdc4cb4",
"name" : "accampus",
"messageId" : "DEVICECONFIG_74f70f6630874f87a8598cf44ae906ca",
"operation" : "0",
"state" : "3",
"errorMessage" : "internal error",
"updateTime" : "2019-05-30 15:12:50"
}
]
}
]
}
]
}
-
请求示例 HTTP的示例 POST /controller/campus/v1/networkconfigservice/configresult 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
{
"pageIndex" : "1",
"pageSize" : "20",
"siteIds" : ["770545b0-e306-4c9a-9b7d-d76fc5f60182"],
"deviceIds" : ["d623ead6-a2cc-4c3c-9039-dcc8fa898a60"]
}
-
响应参数 返回状态码为200:查询设备配置结果成功。 表3 StateResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data ARRAY_REFERENCE 详细请参见表4。 配置结果信息。 - 表4 ConfigStateResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string - - 设备ID。 "d623ead6-a2cc-4c3c-9039-dcc8fa898a60" esn string - - 设备ESN。 "AA50082935AAAC003037" configStates ARRAY_REFERENCE 详细请参见表5。 设备的各个特性配置结果。 - 表5 FeatureStateDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 featureIdentify string - - 特性类型。 "initloginuser" state int32 - - 配置下发状态,取值范围:0---成功;1---告警;2---预配置;3---失败;4---正在下发。 0 featureItems ARRAY_REFERENCE 详细请参见表6。 设备对应特性的配置结果。 - 表6 FeatureItemStateDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 单个特性ID。 "7b4b8bedffdc416ab97c406fdbdc4cb4" name string - - 单个特性名称。 "accampus" messageId string - - 下发单个特性的报文ID。 "DEVICECONFIG_74f70f6630874f87a8598cf44ae906ca" operation int32 - - 单个特性对应的操作类型,取值范围:0---新增(Add);1---删除(Delete);2---修改(Update)。 "0" state int32 - - 单个特性的配置下发状态,取值范围:0---成功;1---告警;2---预配置;3---失败;4---正在下发。 "3" errorMessage string - - 错误信息。 "internal error" updateTime string - - 更新时间。 "2019-05-30 15:12:50"