您可以使用标签功能来为产品、设备或分组自定义标识,以便灵活管理产品、设备和分组;还可以使用地理位置标签标记设备地理位置,为设备设置GeoLocation属性值

背景信息

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

产品标签、设备标签和分组标签的结构为Key:Value

说明 每个产品、设备或分组最多可有100个标签。

产品标签

产品标签通常描述的是对一个产品下所有设备所具有的共性信息。如产品的制造商、所属单位、外观尺寸、操作系统等。需在创建产品后,再为该产品添加产品标签。

在控制台添加产品标签操作步骤:

  1. 登录物联网平台控制台
  2. 实例概览页,找到对应的实例,单击实例进入实例详情页。
    实例概览
  3. 在左侧导航栏,选择设备管理 > 产品
  4. 产品页面,找到需要添加标签的产品,并单击对应操作栏中的查看
  5. 单击标签信息右侧的编辑按钮。
    产品标签
  6. 在弹出的对话框中,输入标签的标签Key标签Value,然后单击确认
    参数 说明
    标签Key 可包含英文字母、数字和点号(.),长度不超过30个字符。
    标签Value 可包含中文、英文字母、数字、日文、下划线(_)、短划线(-)、英文冒号(:)和点号(.),长度不超过128个字符,一个中文或日文占2个字符。

设备标签

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

设备标签信息会跟随设备在系统内部流转。并且,物联网平台可以基于规则引擎的数据流转功能,将设备标签添加到设备上报的消息体里,并发送给其它阿里云产品。

在控制台添加设备标签的操作步骤:

  1. 登录物联网平台控制台
  2. 实例概览页,找到对应的实例,单击实例进入实例详情页。
    实例概览
  3. 在左侧导航栏,选择设备管理 > 设备
  4. 设备页面,单击要添加标签的设备所对应的查看,进入设备详情页面。
  5. 单击标签信息右侧的编辑按钮。
    设备标签
  6. 在弹出的对话框中,输入标签的标签Key标签Value,然后单击确认
    参数 说明
    标签Key 可包含英文字母、数字、下划线(_)、短划线(-)、井号(#)、at(@)、百分号(%)、and(&)、星号(*)和点号(.),长度不超过30个字符。
    标签Value 可包含中文、英文字母、数字、日文、下划线(_)和短划线(-)、井号(#)、at(@)、百分号(%)、and(&)、英文冒号(:)和点号(.),长度不超过128个字符,一个中文或日文占2个字符。

分组标签

设备分组用于跨产品管理设备。分组标签通常描述的是一个分组下所有设备和子分组所具有的共性信息,如分组下的设备所在的地域、空间等。需在创建分组后,再为该分组添加标签。

在控制台添加分组标签操作步骤:

  1. 登录物联网平台控制台
  2. 实例概览页,找到对应的实例,单击实例进入实例详情页。
    实例概览
  3. 在左侧导航栏,选择设备管理 > 分组
  4. 分组页面,找到需要添加标签的分组,并单击对应操作栏中的查看
  5. 单击标签信息右侧的编辑按钮。
    分组标签
  6. 在弹出的对话框中,输入标签的标签Key标签Value,然后单击确认
    参数 说明
    标签Key 可包含英文字母、数字和点号(.),长度不超过30个字符。
    标签Value 可包含中文、英文字母、数字、日文、下划线(_)、短划线(-)、英文冒号(:)和点号(.),长度不超过128个字符,一个中文或日文占2个字符。

地理位置标签

地理位置标签用于标记设备的地理位置,结构为coordinate: 经度:纬度

如果设备所属产品的物模型包含GeoLocation属性,设置地理位置标签后,该地理位置信息将同步为GeoLocation属性值。

在控制台设置地理位置标签的操作步骤:

  1. 登录物联网平台控制台
  2. 实例概览页,找到对应的实例,单击实例进入实例详情页。
    实例概览
  3. 在左侧导航栏,选择设备管理 > 设备
  4. 设备页面,单击要添加标签的设备所对应的查看,进入设备详情页面。
  5. 单击标签信息右侧的编辑按钮。
    地理位置标签
  6. 在弹出的对话框中,单击地理位置标签的文本框,在弹出的地图中选择位置,可以按地址搜索。
  7. 单击设备标签文本框后的删除
  8. 单击确认,完成设置。

批量操作标签

除在控制台创建、编辑和删除标签外,您还可以调用物联网平台提供的API来批量管理标签。此外,物联网平台还提供API,用于根据标签来查询产品、设备和分组,请参见API列表