全部产品
云市场

标签

更新时间:2019-06-25 09:45:26

功能介绍

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

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

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

关于标签的更多介绍详见物联网平台标签中的描述。

SDK使用

更新标签

API原型 device#postTags(params, [callback])
函数描述 上报或更新设备标签
参数描述
- params 属性对象数组,array 类型,内容格式示例 [ {attrKey:’xxx’,attrValue:’xxx’},{}…]
- callback
- res 服务端 reply 消息内容

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

  1. const tags = [
  2. {
  3. "attrKey": "Temperature",
  4. "attrValue": "36.8"
  5. }
  6. ]
  7. device.postTags(
  8. tags,
  9. (res) => {
  10. console.log(`add tag ok res:${res.id}`);
  11. done()
  12. }
  13. );

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

删除标签

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

代码示例:

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

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

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