CDN加速

新增设备信息

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

适用产品:通用功能

接口描述

支持第三方提交待接入纳管的设备信息

请求参数

JSON
参数名称类型必填描述
deviceListarray添加设备信息列表,支持同时添加多台设备信息,每次提交设备数量不超过 500 台
┗deviceSnstring设备 SN 号,唯一标识。
┗deviceTypestring设备类型,值为:PM(物理机)、VM(虚拟机)
┗areastring机房物理所在区域,具体到省市,例如:浙江省金华市
┗ispstring机房网络所在运营商,例如:电信、联通、移动
┗networkobject设备所处的网络环境数据。
┗┗bandwidthUpstreamfloat上行行带宽,单位:Mbps,保留两位小数
┗┗bandwidthDownstreamfloat下行带宽,单位:Mbps,保留两位小数
┗requestTimestring请求时间,格式为 yyyy-MM-dd HH: mm :ss,与服务器时间差异大于半小时的请求会被拒绝。

返回参数

JSON
参数名称类型描述
successListarray成功添加的设备信息列表,只返回添加成功的设备 SN
┗deviceSnstring设备 SN 号 设备 SN 号
failedListstring添加失败的设备信息列表 ,返回添加失败的设备 SN、错误码及失败描述信息
┗errorCodeint单条数据操作的错误码,详见接口错误码说明
┗detailstring失败描述信息

错误码

错误代码(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/add-device-info" \

-X "POST" \

-u "$username:$password" \

-H "Date: $date" \

-H "Accept: application/json" \

-d '{
    "deviceList":[
        {
            "deviceSn":"02100006a827b56f5bd9dsrg1",
            "deviceType":"PM",
            "area":"xxx 省 xxx 市",
            "isp":"电信",       
            "network":{
                "bandwidthUpstream":10,
                "bandwidthDownstream":10
            }
        },
        {
            "deviceSn":"02100006a827b56f5bd9dsrg2",
            "deviceType":"PM",
            "area":"xxx 省 xxx 市",
            "isp":"电信",
            "network":{
                "bandwidthUpstream":100,
                "bandwidthDownstream":100
            }
        }
    ],
    "requestTime":"2019-01-16 17:30:00"
}'
返回示例
复制
{
    "code":"0",
    "message":"Success",
    "data":{
        "successList":[
            "02100006a827b56f5bd9dsrg1",
            "02100006a827b56f5bd9dsrg2"
        ],
        "failedList":[

        ]
    }
}