您可以使用标签功能为产品、设备或分组自定义标识，以便灵活管理产品、设备和分组；使用地理位置标签标记设备地理位置，为设备设置GeoLocation属性值。本文介绍添加标签的操作步骤。

前提条件

添加标签前，需先对应完成产品、设备或分组的创建，请参见：

背景信息

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

使用说明

  • 产品标签、设备标签和分组标签的结构为Key:Value。
  • 每个产品、设备或分组最多可有100个标签。

添加产品标签

产品标签通常描述一个产品下所有设备所具有的共性信息。如产品的制造商、所属单位、外观尺寸、操作系统等。

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

添加设备标签

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

  • 设备标签信息会跟随设备在系统内部流转，流转的数据格式，请参见设备标签的Alink协议。
  • 物联网平台可基于规则引擎的数据流转功能，将设备标签添加到设备上报的消息体里，并发送给其它阿里云产品。流转的数据格式，请参见设备标签变更。
  1. 在目标实例的左侧导航栏，选择设备管理 > 设备。
  2. 在设备页面，单击要添加标签的设备所对应的查看。
  3. 在设备详情页面，单击标签信息右侧的编辑。
    设备标签
  4. 可选：在编辑标签对话框中，单击地理位置标签的文本框，在弹出的地图中选择位置，可以按地址搜索。
    说明 地理位置标签用于标记设备的地理位置，结构为 coordinate: 经度:纬度。

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

  5. 在编辑标签对话框中，单击新增标签，输入标签的标签Key和标签Value。
    参数 说明
    标签Key 可包含英文字母、数字、正斜线（/）、下划线（_）、短划线（-）、井号（#）、at（@）、百分号（%）、and（&）、星号（*）和英文句号（.），长度不超过30个字符。
    标签Value 可包含中文、英文字母、数字、日文、下划线（_）和短划线（-）、井号（#）、at（@）、百分号（%）、and（&）、英文冒号（:）和英文句号（.），长度不超过128个字符，一个中文或日文占2个字符。
  6. 单击确认。

添加分组标签

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

  1. 在目标实例的左侧导航栏，选择设备管理 > 分组。
  2. 在分组页面，找到需要添加标签的分组，并单击对应操作栏中的查看。
  3. 单击标签信息右侧的编辑。
    分组标签
  4. 可选：在编辑标签对话框中，单击地理位置标签的文本框，在弹出的地图中选择位置，可以按地址搜索。
    说明 地理位置标签用于标记设备的地理位置，结构为 coordinate: 经度:纬度。

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

  5. 在编辑标签对话框中，输入标签的标签Key和标签Value，然后单击确认。
    参数 说明
    标签Key 可包含英文字母、数字和英文句号（.），长度不超过30个字符。
    标签Value 可包含中文、英文字母、数字、日文、下划线（_）、短划线（-）、英文冒号（:）和英文句号（.），长度不超过128个字符，一个中文或日文占2个字符。

批量操作标签

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