标签

使用与限制

• 产品标签、设备标签和分组标签的结构为Key:Value。
  注意 abc为物联网平台系统保留的标签Key，即标签Key不能设置为abc。若设置Key=abc，使用标签检索时会直接被过滤。
• 每个产品、设备或分组最多可有100个标签。

添加产品标签

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

1. 登录物联网平台控制台。
2. 在实例概览页面，找到对应的实例，单击实例进入实例详情页面。
   注意 目前华东2（上海）、华北2（北京）、华南1（深圳）地域开通了企业版实例服务。其他地域，请跳过此步骤。

   
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列表。