全部产品
云市场

设备标签

更新时间:2019-02-27 19:55:20

功能介绍

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

设备标签的结构为键值对, Key:Value

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

关于标签的更多介绍详见 用户指南/标签 章节。

SDK使用

版本需求

Aliyun IoT Python SDK version >= 1.0.1

更新标签

通过thing_update_tags的接口可以添加以及更新标签,范例

  1. tags = {
  2. "floor": "2f",
  3. "room": "201"
  4. }
  5. rc, request_id = linkkit.thing_update_tags(tags)
  6. if rc == 0:
  7. printf("success")

该接口主要异步化向云平台提交一个更新标签的请求,返回rc, request_id。rc为0标识成功,request_id为提交的请求id, 可以在异步的回调函数中关联该id获取最终的结果。

执行结果将异步返回,可以通过设置回调函数on_thing_device_info_update 获得相关结果,范例如下:

  1. linkkit.on_thing_device_info_update = on_thing_device_info_update
  2. ...
  3. def on_thing_device_info_update(self, request_id, code, data, message, userdata):
  4. print("on_thing_device_info_update: request_id:%s, code:%s, data:%s, message:%s" % (request_id, code, data, message))

标签更新成功可以在控制台查看

image.png | left | 480x110

删除标签

通过thing_remove_tags的接口可以添加以及更新标签,范例

  1. tags = ["floor", "room"]
  2. rc, request_id = linkkit.thing_remove_tags(tags)
  3. if rc == 0:
  4. printf("success")

该接口主要异步化向云平台提交一个删除标签的请求,返回rc, request_id。rc为0标识成功,request_id为提交的请求id, 可以在异步的回调函数中关联该id获取最终的结果。

执行结果将异步返回,可以通过设置回调函数on_thing_device_info_delete 获得相关结果,范例如下:

  1. linkkit.on_thing_device_info_delete = on_thing_device_info_delete
  2. ...
  3. def on_thing_device_info_delete(self, request_id, code, data, message, userdata):
  4. print("on_thing_device_info_delete: request_id:%s, code:%s, data:%s, message:%s" % (request_id, code, data, message))