CDN加速

返回文档中心
API文档
文档中心 API文档 其他 编辑设备信息

编辑设备信息

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

适用产品：WSS

接口描述

支持第三方更新已接入纳管的设备信息

请求参数

JSON

json

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

返回参数

JSON

json

参数名称类型描述
successListarray成功添加的设备信息列表，只返回添加成功的设备 SN
┗deviceSnarray设备 SN 号 设备 SN 号
failedListarray添加失败的设备信息列表 ，返回添加失败的设备 SN、错误码及失败描述信息
┗errorCodeint错误码，详见接口错误码说明
┗detailstring失败描述信息

错误码

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

示例

JSON

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/edit-device-info" \

-X "POST" \

-u "$username:$password" \

-H "Date: $date" \

-H "Accept: application/json" \

-d '{

  "name":"test-namespace-000",

  "description":"this is a test namespace."
  
}'
返回示例
复制 
{
    "code":"0",
    "message":"Success",
    "data":{
        "successList":[
            "02100006a827b56f5bd9dsrg1"
        ],
        "failedList":[
            {
                "deviceSn":"02100006a827b56f5bd9dsrg2",
                "errorCode":10001,
                "detail":"设备不存在"
            }
        ]
    }
}