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

背景信息

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

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

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

产品标签

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

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

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

设备标签

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

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

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

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

分组标签

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

添加分组标签操作步骤：

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

批量操作标签

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