更新设备模型

PUT /api/v1/deviceModels/$modelId

更新设备模型信息

URL参数

参数名 类型 必填 描述 限制
modelId string 模型唯一标识

请求参数

参数名 类型 必填 描述 限制
name string 模型名称 模型名称不能重复
description string 模型描述
deviceType Enum<Stirng> 设备类型 >ROOT:通用设备
>Light:照明设备
>Camera:摄像头
> BallCamera:球机
> GunCamera:枪机
>LocationTracker:定位仪
> PersonalTracker:个人定位仪
> Helmet:智能安全帽
> VehicleTracker:车辆定位仪
>AECMachinery:工程机械设备
> Vehicle:工业车辆
> MiningMachinery:挖掘机械
> Excavator:铲土机械
> Crane:起重机械
>  TowerCrane:塔吊
>  Elevator:升降机
> CompactionMachinery:压实机械
> PileDrivingMachinery:桩工机械
> ConcreteMachinery:混凝土机械
>  ConcreteMixingStation:混凝土搅拌站
> SteelMachine:钢筋机
> RoadMachine:路面机械
> DrillingMachinery:凿岩机械
> DecorationMachinery:装修机械
> TunnelingMachinery:掘进机械
>  ShieldMachine:盾构机
> EnvironmentControlEquipment:环境监测设备
> WeightingEquipment:称重设备
>HVAC:暖通设备
>GATEWAY:网关类设备
imageUrl stirng 模型图片URL
attributesMap Map<String,ModelAttribute> 模型属性列表 模型定义时属性列表attributesMap与操作列表actionsMap不能同时为空
key值为 ModelAttribute中的属性编码code取值
actionsMap Map<String,ModelAction> 模型操作列表 模型定义时属性列表attributesMap与操作列表actionsMap不能同时
key值为 ModelAction中的操作编码code取值为空
metadata Map<String,Object> 设备元数据

ModelAttribute

参数名 类型 必填 描述 限制
name string 属性名称 用于显示可为中文
code string 属性编码 支持字母、下划线_和数字,符合变量定义规范
dataType Enum<String> 属性取值类型 取值:Integer/Float/String/Boolean
description String 属性描述
readable Enum<String> 读写权限 取值R:只读,仅允许数据上行RW:读写,允许上行
W:只写,仅允许下行操作
channel Enum<String> 通道 标用于标识属性类型,取值
m:普通消息类型
w:告警类消息
g:地理位置信息数据

ModelAction

参数名 类型 必填 描述 限制
name string 操作名称 用于显示可为中文
code string 操作编码 支持字母、下划线_和数字,符合函数名定义规范
description String 属性描述
paramsMap Map<String,ActionParams> 操作参数列表 key值为 ActionParams中的参数编码code

ActionParams

参数名 类型 必填 描述 限制
name string 参数名称 用于显示可为中文
code string 参数编码 支持字母、下划线_和数字,符合变量命名规范
description String 参数描述
required Boolean 该参数是否必传
type Enum<String> 参数类型 取值:Integer/Float/String/Boolean

请求样例

PUT /api/v1/deviceModels/9e1a567d-e375-472e-a144-fa9eb8e990b4 HTTP/1.1
Host: 60.205.223.53:8443
Content-Type: application/json
Authorization: Bearer xxx.xxxx.xxx
Cache-Control: no-cache
Postman-Token: 540279be-2161-e130-dcaa-5be2dbd165c6

{
  "name": "deviceUpdateF",
  "description": "desc update",
  "deviceType": "Light",
  "imageUrl": "http://avatar.csdn.net/E/A/0/1_u014231523.jpg",
  "attributesMap":
    {
      "temp": {
        "name": "temp-new-name-put",
        "code": "temp",
        "dataType": "Float",
        "description": "desc",
        "readable": "R",
        "channel": "m"
      }
    }
  ,
  "actionsMap":
    {
      "reset": {
        "name": "ResetName",
        "code": "reset",
        "description": "desc",
        "paramsMap": {
          "flag":{
            "name": "flag",
            "code": "flag",
            "type": "Boolean"
          }
        }
      }
    }

}

响应参数

参数名 类型 必填 描述 限制
id String 模型标识
name string 模型名称
description string 模型描述
deviceType Enum<Stirng> 设备类型
imageUrl stirng 模型图片URL
attributesMap Map<String,ModelAttribute> 模型属性列表
actionsMap Map<String,ModelAction> 模型操作列表
metadata Map<String,Object> 设备元数据

ModelAttribute

参数名 类型 必填 描述 限制
name string 属性名称 用于显示可为中文
code string 属性编码
dataType Enum<String> 属性取值类型 取值:Integer/Float/String/Boolean
description String 属性描述
readable Enum<String> 读写权限 取值R:只读,仅允许数据上行RW:读写,允许上行
W:只写,仅允许下行操作
channel Enum<String> 通道 标用于标识属性类型,取值
m:普通消息类型
w:告警类消息
g:地理位置信息数据

ModelAction

参数名 类型 必填 描述 限制
name string 操作名称
code string 操作编码 支持字母、下划线_和数字,符合函数名定义规范
description String 属性描述
paramsMap Map<String,ActionParams> 操作参数列表 key值为 ActionParams中的参数编码code

ActionParams

参数名 类型 必填 描述 限制
name string 参数名称
code string 参数编码 支持字母、下划线_和数字,符合变量命名规范
description String 参数描述
required Boolean 该参数是否必传
type Enum<String> 参数类型 取值:Integer/Float/String/Boolean

响应样例

{
    "returnCode": 0,
    "result": {
        "createdBy": "augur@glodon.com",
        "updatedBy": "augur@glodon.com",
        "createdTime": 1505873265340,
        "updatedTime": 1505873290544,
        "tenantId": "96345b4a-8705-4fe8-8b92-5533f114ad6a",
        "id": "9e1a567d-e375-472e-a144-fa9eb8e990b4",
        "name": "deviceUpdateF",
        "description": "desc update",
        "deviceType": "Light",
        "imageUrl": "http://avatar.csdn.net/E/A/0/1_u014231523.jpg",
        "attributesMap": {
            "temp": {
                "name": "temp-new-name-put",
                "code": "temp",
                "dataType": "Float",
                "description": "desc",
                "readable": "R",
                "channel": "m"
            }
        },
        "actionsMap": {
            "reset": {
                "name": "ResetName",
                "code": "reset",
                "description": "desc",
                "paramsMap": {
                    "flag": {
                        "name": "flag",
                        "code": "flag",
                        "required": false,
                        "type": "Boolean"
                    }
                }
            }
        },
        "deleted": false
    }
}