文档中心 API文档 获取设备信息

获取设备信息

更新时间:2019-09-25 14:18:52

适用产品

WSS

接口描述

删除纳管的第三方设备信息

请求参数

Body 参数

JSON
参数名称类型必填描述
deviceSn
string设备 SN 号,唯一标识。
requestTime
string请求时间,格式为 yyyy-MM-dd HH: mm :ss,与服务器时间差异大于半小时的请求会被拒绝。

返回参数

Body 参数

JSON
参数名称类型描述
deviceList
array以设备 SN 为 key,设备基础信息列表为 value 的对象。
┗deviceSn
string设备 SN 号,唯一标识。
┗macAddress
stringMAC 地址
┗romVersion
string系统版本号
┗ip
string外网 IP
┗innerIp
string内网 IP
┗natType
stringNAT 类型
┗deviceStatus
string设备状态,在线(online)离线(offline)异常(abnormal)待激活(inactive)
┗onlineDuration
array在线时长
┗uploadSpeed
string上行测速值,单位 Mbps
┗cpu
objectcpu相关信息
┗┗model
stringcpu 型号 磁盘型号
┗┗cores
intcpu 核数
┗┗freq
arraycpu 主频,单位 MHz
┗memory
int内存大小 单位 MB
┗disk
array磁盘相关信息
┗┗name
string磁盘名称
┗┗size
string磁盘大小,单位 GB
┗┗ssd
boolean是否是固态硬盘
┗┗mounted
boolean是否挂载
┗temperature
string温度
┗infoUpdateTime
string设备基础信息更新时间,即 NAT 类型、cpu、内存、磁盘等信息更新时间,格式为 yyyy-MM-dd HH: mm :ss
┗speedUpdateTime
string上行测速更新时间,格式为 yyyy-MM-dd HH: mm :ss
┗errorCode
int单条数据操作的错误码,详见接口错误码说明
┗detail
string失败描述信息

错误码

错误代码(code)描述(message)HTTP状态码语义
32782001request format error400请求格式错误
32782002missing argument400缺少必要参数
32782003illegal argument400参数非法
32782004other error400其他错误

示例

JSON
JSON
请求示例
复制代码 复制成功
#!/bin/bash

username="example_username"

apiKey="example_apiKey"

date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`

password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`

curl -i --url "https://open-its.chinanetcenter.com/boxplatform/openapi/v1/get-device-info" \

-X "POST" \

-u "$username:$password" \

-H "Date: $date" \

-H "Accept: application/json" \

-d '{
    "deviceSn":"02100006a827b56f5bd9dsrg1,02100006a827b56f5bd9dsrg2",
    "requestTime":"2019-01-07 17:30:00"
}'
返回示例
复制代码 复制成功
{
    "code":"0",
    "message":"Success",
    "data":{
        "deviceList":[
            {
                "deviceSn":"02100006a827b56f5bd9dsrg1",
                "macAddress":"xxxxxx",
                "romVersion":"xxxxxx",
                "natType":"xxxxxx",
                "ip":"xxxxxx",
                "innerIp":"xxxxxx",
                "deviceStatus":"online",
                "onlineDuration":"",
                "uploadSpeed":10,
                "cpu":{
                    "model":"ARMv8 Processor rev 4 (v8l)",
                    "cores":4,
                    "freq":1512
                },
                "memory":1845,
                "disk":[
                    {
                        "name":"ssd",
                        "model":"Seagate Slim BK",
                        "size":100,
                        "ssd":true,
                        "mounted":false
                    }
                ],
                "temperature":"",
                "infoUpdateTime":"2019-03-18 12:30:00",
                "speedUpdateTime":"2019-03-18 12:40:00"
            },
            {
                "deviceSn":"02100006a827b56f5bd9dsrg2",
                "macAddress":"xxxxxx",
                "romVersion":"xxxxxx",
                "natType":"xxxxxx",
                "ip":"xxxxxx",
                "innerIp":"xxxxxx",
                "deviceStatus":"offline",
                "onlineDuration":"",
                "uploadSpeed":10,
                "cpu":{
                    "model":"ARMv8 Processor rev 4 (v8l)",
                    "cores":4,
                    "freq":1512
                },
                "memory":1845,
                "disk":[
                    {
                        "name":"ssd",
                        "model":"Seagate Slim BK",
                        "size":100,
                        "ssd":true,
                        "mounted":false
                    }
                ],
                "temperature":"",
                "infoUpdateTime":"2019-03-18 12:50:00",
                "speedUpdateTime":"2019-03-18 12:50:00"
            }
        ]
    }
}
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!