物联网平台的标签功能_物联网平台(IoT)-阿里云帮助中心

物联网平台提供标签功能，支持使用自定义标签来标识产品、设备或分组，实现从不同维度将具有相同特性的设备归类，便于搜索、聚合设备资源，以便更灵活管理物联网平台设备。本文介绍标签的具体使用方法。

使用说明

标签	说明
产品标签	用于描述同一个产品下所有设备所具有的共性信息。例如：使用产品的制造商、所属单位、外观尺寸、操作系统等标记产品。
设备标签	根据设备的特性为设备添加特有的标签，方便统计并归类一批设备进行聚合展示和管理。例如，为房间201的智能电表定义一个标签为`room:201`。
分组标签	用于跨产品管理设备，描述一个分组下所有设备和子分组所具有的共性信息。例如：分组下的设备所在地域、空间等。

应用场景

通过标签批量操作

标签	操作示例
产品标签	根据标签信息查找物联网平台对应实例下的共性产品。
设备标签	根据标签信息搜索目标设备后，可批量操作：启用、禁用、删除设备。具体内容，请参见禁用和启用设备和删除设备。在设备分组或设备OTA升级中，通过高级搜索功能快速筛选指定标签设备，加入到目标分组或OTA升级任务中。具体内容，请参见高级搜索。
分组标签	根据标签信息查找物联网平台对应实例下的具有共性的分组或子分组。

设备端批量操作标签信息

在设备端完成标签管理功能开发后，设备端支持管理标签信息：

上报标签：设备上报标签信息后，在物联网平台控制台对应设备中自动添加或更新对应标签信息。
删除标签：设备发送删除标签的请求，物联网平台收到请求后，会删除对应标签信息。
获取标签信息：设备发送获取标签信息的请求，物联网平台收到请求后，返回对应标签信息。

在物联网平台提供多语言的设备端Link SDK已集成标签功能，使设备标签信息跟随设备在物联网平台系统内部流转。设备端Link SDK代码示例，请参见设备开发的设备标签。管理标签信息的Topic和数据格式，请参见设备标签的Alink协议。

服务端订阅或通过云产品流转设备标签变更信息

物联网平台可基于消息转发的数据流转功能，将设备标签操作（添加、更新、删除、清空）添加到设备上报的消息体里，并发送给业务服务器或其它阿里云产品。数据流转配置，请参见消息转发。流转的数据格式，请参见设备标签变更。

前提条件

已登录物联网平台控制台。
添加标签前，需先对应完成产品、设备或分组的创建。具体操作，请参见：
- 创建产品。
- 创建设备。
- 创建分组。

背景信息

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

使用限制

产品标签、设备标签和分组标签的结构为Key:Value。
abc为物联网平台系统保留的标签Key，即标签Key不能设置为abc。若设置Key=abc，使用标签检索时会直接被过滤。
标签Key中的英文字符大小写不敏感，但物联网平台系统内部以及消息转发流转的标签信息中，会一直使用首次添加标签信息中的Key字段。
即使删除标签，重新添加标签仅修改英文大小写，流转的标签信息中Key也仍然使用删除前首次设置该标签信息中的Key。
例如：设置标签ssid:1000，后续更新标签使用Ssid:1001，可以更新Value成功，但系统内容流转的数据格式中仍然使用ssid:1001。
每个产品、设备或分组最多可有100个标签。

在控制台编辑标签

编辑产品标签

在实例概览页签的全部环境下，找到对应的实例，单击实例卡片。
在左侧导航栏，选择设备管理 > 产品。
在产品页面，找到需要添加标签的产品，并单击对应操作栏中的查看。
标签信息区域，展示当前产品下所有的标签信息。
单击标签信息右侧的编辑。

在编辑标签对话框中，输入标签的标签Key和标签Value。

参数	说明
标签Key	可包含英文字母、数字和英文句号（.），长度不超过30个字符。
标签Value	可包含中文、英文字母、数字、日文、下划线（_）、短划线（-）、英文冒号（:）和英文句号（.），长度不超过128个字符，一个中文或日文占2个字符。

（可选）您可单击新增标签，添加多对标签，也可单击删除，删除无用的标签。
单击确认。

编辑设备标签

在目标实例的左侧导航栏，选择设备管理 > 设备。
在设备页面，单击要添加标签的设备所对应的查看。
标签信息区域，展示当前设备下所有的标签信息。
在设备详情页面，单击标签信息右侧的编辑。

在编辑标签对话框中，单击新增标签，输入标签的标签Key和标签Value。

参数	说明
标签Key	可包含英文字母、数字、正斜线（/）、下划线（_）、短划线（-）、井号（#）、at（@）、百分号（%）、and（&）、星号（*）和英文句号（.），长度不超过30个字符。
标签Value	可包含中文、英文字母、数字、日文、下划线（_）和短划线（-）、井号（#）、at（@）、百分号（%）、and（&）、英文冒号（:）和英文句号（.），长度不超过128个字符，一个中文或日文占2个字符。

可选：在编辑标签对话框中，单击地理位置标签的文本框，在弹出的地图中选择位置，可以按地址搜索。
重要
地理位置标签用于标记设备的地理位置，结构为coordinate: ${经度}:${纬度}。
如果设备所属产品的物模型包含GeoLocation属性，在控制台设置地理位置标签后，该地理位置信息将同步为GeoLocation属性值。但通过云端API和设备上报设置的地理位置标签信息，不会同步到GeoLocation属性。
（可选）您可单击新增标签，添加多对标签，也可单击删除，删除无用的标签。
单击确认。

编辑分组标签

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

在编辑标签对话框中，输入标签的标签Key和标签Value。

参数	说明
标签Key	可包含英文字母、数字和英文句号（.），长度不超过30个字符。
标签Value	可包含中文、英文字母、数字、日文、下划线（_）、短划线（-）、英文冒号（:）和英文句号（.），长度不超过128个字符，一个中文或日文占2个字符。

（可选）您可单击新增标签，添加多对标签，也可单击删除，删除无用的标签。
单击确认。

通过云端API批量操作标签

物联网平台提供了云端API来批量管理标签，或根据标签来查询产品、设备和分组。

产品标签

功能	API	描述
编辑标签	CreateProductTags	创建产品标签。
	UpdateProductTags	更新产品标签。
	DeleteProductTags	删除产品标签。
查看标签	ListProductTags	查询产品的所有标签。
使用标签	ListProductByTags	根据标签查询产品。

设备标签

功能	API	描述
编辑标签	SaveDeviceProp	设置设备标签。
编辑标签	DeleteDeviceProp	删除设备标签。
查询标签	QueryDeviceProp	查询指定设备下的标签列表。
使用标签	QueryDeviceByTags	根据标签查询设备。

分组标签

功能	API	描述
编辑标签	SetDeviceGroupTags	添加、更新或删除分组标签。
查询标签	QueryDeviceGroupTagList	查询分组标签列表。
使用标签	QueryDeviceGroupByTags	根据标签查询设备分组。