云服务器内容精选

  • 响应示例 返回状态码为200:查询成功,响应体参考BatchQueryResult。 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 { "errorCode" : "0x00c80035", "errorMessage" : "参数非法", "totalCounts" : "", "deviceList" : [ { "siteName" : "siteName", "siteId" : "00000000-0000-0000-0000-000000000001", "deviceType" : "LSW", "deviceModel" : "USG6380", "role" : "ACC", "id" : "00000000-0000-0000-0000-000000000001", "esn" : "0088032VRE1234567890", "name" : "name", "firstConnectTime" : "1686532310230", "lastConnectTime" : "1686532310230", "approvalStatus" : 1, "failReason" : "设备类型不匹配", "nameModifyFlag" : "true", "siteModifyFlag" : "true", "stackMasterEsn" : "0088032VRE1234567890", "mac" : "01-80-C2-00-00-00", "discoveryType" : 1, "discoveryParentId" : "00000000-0000-0000-0000-000000000001" } ] } 返回状态码为400:设备ID格式错误时返回,响应体参考ErrorResponse。 HTTP/1.1 400 Bad Request 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 { "errorCode" : "0x00c80035", "errorMessage" : "参数非法" } 返回状态码为500:服务内部异常时返回,响应体参考ErrorResponse。 HTTP/1.1 500 Internal Server Error 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 { "errorCode" : "0x00c80035", "errorMessage" : "参数非法" }
  • 响应参数 返回状态码为200:查询成功,响应体参考BatchQueryResult。 表3 BatchQueryResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errorCode string 1~128个字符。 - 错误码 "0x00c80035" errorMessage string 1~128个字符。 - 错误原因 "参数非法" totalCounts int32 [0-200000] - 数据总数 - deviceList ARRAY_REFERENCE 0-300个列表项,详细请参见表4。 设备信息 - 表4 DeviceApprovalDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 siteName string 2~32个字符。 - 站点名 该字段对应UI页面上是:UI【站点】 "siteName" siteId string 1~64个字符。 - 站点id "00000000-0000-0000-0000-000000000001" deviceType string 1~10个字符。 - 设备类型 该字段对应UI页面上是:UI【类型】 "LSW" deviceModel string 1~32个字符。 - 设备型号 该字段对应UI页面上是:UI【设备型号】 "USG6380" role string 1~10个字符。 - 设备角色 该字段对应UI页面上是:UI【角色】 "ACC" id string 1~64个字符。 - 设备id "00000000-0000-0000-0000-000000000001" esn string 1~64个字符。 - 设备ESN 该字段对应UI页面上是:UI【ESN】 "0088032VRE1234567890" name string 1~256个字符。 - 设备名称 该字段对应UI页面上是:UI【设备名称】 "name" firstConnectTime string 1~16个字符。 - 初次连接时间 该字段对应UI页面上是:UI【初次连接时间】 "1686532310230" lastConnectTime string 1~16个字符。 - 最后连接时间 该字段对应UI页面上是:UI【最后连接时间】 "1686532310230" approvalStatus int32 [0-2] - 审批状态 1 failReason string 1~32个字符。 - 失败原因 该字段对应UI页面上是:UI【失败原因】 "设备类型不匹配" nameModifyFlag string 1~8个字符。 - 是否修改过名称 "true" siteModifyFlag string 1~8个字符。 - 是否修改过站点 "true" stackMasterEsn string 1~64个字符。 - 堆叠主esn "0088032VRE1234567890" mac string 1~32个字符。 - 一体机从设备的MAC "01-80-C2-00-00-00" discoveryType int32 [1-2] - 发现渠道 1、免ESN发现 2、一体机发现 1 discoveryParentId string 1~64个字符。 - 一体机设备ID "00000000-0000-0000-0000-000000000001" 返回状态码为400:设备ID格式错误时返回,响应体参考ErrorResponse。 表5 ErrorResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errorCode string 1~128个字符。 - 错误码 "0x00c80035" errorMessage string 1~128个字符。 - 错误原因 "参数非法" 返回状态码为500:服务内部异常时返回,响应体参考ErrorResponse。 ErrorResponse对象的参数列表,详细请参见表5。
  • 请求示例 HTTP的示例 POST /v1/devicemgr/access-approvals/action/batch-query 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 { "keyWord" : "00000", "deviceTypes" : ["AP","LSW"], "siteIds" : ["00000000-0000-0000-0000-000000000001"], "pageIndex" : 1, "pageSize" : 20, "status" : [1,2], "discoveryType" : [1,2] }
  • 请求示例 HTTP的示例 PUT /v1/devicemgr/access-approvals 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 { "siteId" : "00000000-0000-0000-0000-000000000001", "role" : "ACC", "devices" : ["00000000-0000-0000-0000-000000000001"] }
  • 响应参数 返回状态码为200:修改成功,响应体参考BatchUpdateResult。 表3 BatchUpdateResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errorCode string 1~128个字符。 - 错误码 "0x00c80035" errorMessage string 1~128个字符。 - 错误原因 "参数非法" 返回状态码为400:设备ID格式错误时返回,响应体参考ErrorResponse。 ErrorResponse对象的参数列表,详细请参见表5。 返回状态码为500:服务内部异常时返回,响应体参考ErrorResponse。 ErrorResponse对象的参数列表,详细请参见表5。
  • 响应示例 返回状态码为200:修改成功,响应体参考BatchUpdateResult。 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 { "errorCode" : "0x00c80035", "errorMessage" : "参数非法" } 返回状态码为400:设备ID格式错误时返回,响应体参考ErrorResponse。 HTTP/1.1 400 Bad Request 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 { "errorCode" : "0x00c80035", "errorMessage" : "参数非法" } 返回状态码为500:服务内部异常时返回,响应体参考ErrorResponse。 HTTP/1.1 500 Internal Server Error 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 { "errorCode" : "0x00c80035", "errorMessage" : "参数非法" }