物联网平台的设备标签是给设备添加自定义的标识。您可以使用标签功能来灵活管理产品、设备和分组。

功能介绍

设备标签的结构为键值对, Key:Value

您可以根据设备的特性为设备添加特有的标签,方便对设备进行管理。例如,为房间 201 的智能电表定义一个标签为room:201

SDK使用

更新标签

API原型 device#postTags(params, [callback])
函数描述 上报或更新设备标签
参数描述

- params 属性对象数组,array 类型,内容格式示例 [ {attrKey:’xxx’,attrValue:’xxx’},{}…]

- callback

- res 服务端 reply 消息内容

下面的示例代码向云端添加一个名为“Temperature”的标签,其值为“36.8”:

const tags = [
  {
    "attrKey": "Temperature",
    "attrValue": "36.8"
  }
]
device.postTags(
  tags,
  (res) => {
    console.log(`add tag ok res:${res.id}`);
    done()
  }
);
            

注:设备可以向云端添加多个标签

删除标签

API原型 device#deleteTags(tags)
函数描述 删除设备标签
参数描述 - tags 属性参数,array 类型,内容格式 [ 'string','string',....],string 内外为tag的标签名称

代码示例:

device.deleteTags(['tagA','tagB']);
            

上面的示例代码删除名为“tagA”和“tagB”的两个标签。

开发者也可访问完整代码示例了解相关用法。