云服务器内容精选

华为云首页用户手册

设备基本信息管理

华为乾坤-查询设备:URI

URI /controller/campus/v3/devices 表1 query参数列表参数名称必选类型参数值域默认值参数说明参数示例 pageIndex 否 int32 [0-2147483647] 1 分页的序号。 1 pageSize 否 int32 [0-1000] 1000 分页的大小。 20 neType 否 string 0~128个字符。 - 设备类型，类型可以是'AR'，'AP'，'LSW'，'FW'，如果多个类型用逗号分隔（如：AR，AP）。不推荐使用，请尽量以deviceType为主。 "AP,AR" deviceType 否 string 0~128个字符。 - 设备类型，类型可以是'AR'，'AP'，'LSW'，'FW'，如果多个类型用逗号分隔（如：AR，AP）。如果跟neType同时出现，以deviceType为主。 "AP,AR" siteId 否 string 0~128个字符。 - 站点ID，查询单个站点下设备列表，为空查询所有设备。 "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca" sort 否 string 0~128个字符。 - 排序字段，支持name，esn，deviceModel，deviceType，status，mac，ip，neType，version，description，createTime，registerTime，modifyTime。 "name" name 否 string 0~128个字符。 - 设备名称模糊查询，支持精确和模糊匹配，不支持正则。 "deviceName" esn 否 string 0~128个字符。 - 设备ESN精确查询。 "1002352CQW1910029317" mac 否 string 0~128个字符。 - 设备MAC地址精确查询。 "xx-xx-xx-xx-xx-xx" ip 否 string 0~128个字符。 - 设备IP地址精确查询。 "192.168.1.1" registerTimeBegin 否 int64 - - 注册时间查询范围起始值。 1598494534 registerTimeEnd 否 int64 - - 注册时间查询范围结束值。 1598494534 createTimeBegin 否 int64 - - 创建时间查询范围起始值。 1598494534 createTimeEnd 否 int64 - - 创建时间查询范围结束值。 1598494534

华为乾坤设备基本信息管理
华为乾坤-查询设备:请求示例

请求示例 HTTP的示例 GET /controller/campus/v3/devices?pageIndex=1&pageSize=20&neType=AP,AR&deviceType=AP,AR&siteId=ea25fdbf-8dee-4823-bac2-5bfe8e3359ca&sort=name&name=deviceName&esn=1002352CQW1910029317&mac=xx-xx-xx-xx-xx-xx&ip=192.168.1.1®isterTimeBegin=1598494534®isterTimeEnd=1598494534&createTimeBegin=1598494534&createTimeEnd=1598494534 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：查询设备信息成功，响应体参考GetDeviceResponseBean。 HTTP/1.1 200 OK Date: Sun,10 Sep 2023 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "success", "pageIndex" : 1, "pageSize" : 20, "totalRecords" : 2, "data" : [ { "id" : "b473118d-17ff-4f4f-9fa9-a4c0e1e87e42", "name" : "AR1", "esn" : "2102351BTJ0000000666", "deviceModel" : "AR161EW", "deviceType" : "AR", "status" : "0", "siteId" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca", "mac" : "xx-xx-xx-xx-xx-xx", "ip" : "192.168.0.10", "manageIp" : "192.168.0.10", "neType" : "AR161EW", "version" : "V300R003C00", "vendor" : "HUAWEI", "description" : "HUAWEI", "resourceId" : "HUAWEI", "tenantId" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca", "tenantName" : "tenant@huawei.com", "siteName" : "test1", "createTime" : "2017-12-13 01:37:28", "registerTime" : "2017-12-13 01:37:28", "modifyTime" : "2017-12-13 01:37:28", "startupTime" : "2017-12-13 01:37:28", "tags" : [ "" ], "systemIp" : "192.168.1.1", "patchVersion" : "V200R019SPH", "ztpConfirm" : false, "manageStatus" : "ABNORMAL", "manageStatusDownReason" : ["NEED_ZTP_CONFIRM","DEVICE_HAS_BEEN_ISOLATED"], "role" : ["Gateway"], "performance" : "", "uptime" : "0 天 1 时 10 分" } ] }

华为乾坤设备基本信息管理