阿里云物联网平台使用教程7-标签功能

1.介绍

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

物联网往往涉及量级产品与设备的管理。如何区分不同批次的产品与设备，如何实现批量管理，成为一大挑战。阿里云物联网平台为解决这一问题提供了标签功能。可以为不同产品、设备或设备分组贴上不同标签，然后根据标签实现分类统一管理;

标签包括产品标签、设备标签和分组标签;

标签的结构为Key:Value;

例如，为房间 201 的智能电表定义一个标签为room:201。

注意: 每个产品、设备或分组最多可有100个标签。

使用标签功能有两个步骤:

阿里云物联网平台设置产品标签、设备标签和分组标签;
设备端更新/删除设备标签

2. 云平台设置标签

在阿里云物联网平台设置产品标签、设备标签和分组标签的具体过程,可查阅官网教程。

官网教程传送门:

https://help.aliyun.com/document_detail/73733.html?spm=a2c4g.11186623.2.15.7ee31f0aAQ9cfX

3.设备端操作设备标签

3.1更新标签

//API device.postTags(params, [callback]) 上报或更新设备标签

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

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

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

3.2删除标签

//API device.deleteTags(tags) 删除设备标签

device.deleteTags(['tagA','tagB']);
示例代码删除名为“tagA”和“tagB”的两个标签。

官网的实例代码:

const iot = require('../');

// init device and connect linkplatform
const device = iot.device({
  "PRODUCTKEY": "a1ouyopKiEU",
  "DeviceName": "device1",
  "DeviceSecret": "mi9FfuIN28blO1n4oSytBi2kvcWoJzTj"
});

device.on('connect', () => {
  console.log('>>>>>device connect succeed');
  // post device tag
  const tagsInfo = [
    {"attrKey": "Temperature","attrValue": "36.8"},
    {"attrKey": "Room","attrValue": "avalu301e"}];
  device.postTags(
    tagsInfo,
    (res) => {
      console.log("post tags result:",res);
    });
  // delete tag after ten seconds
  setTimeout(()=>{
    device.deleteTags(['Temperature','Room'], (res) => {
      console.log(`tag delete succeed`);
    });
  },10000)
});