前提條件

需物模型初始化完成后（on_thing_enable回調被SDK觸發之后）才能使用設備標簽的API。

功能介紹

設備標簽的結構為鍵值對，Key:Value。

您可以根據設備的特性為設備添加特有的標簽，方便對設備進行管理。例如，為房間201的智能電表定義一個標簽為room:201。您可以在控制臺管理設備標簽，也可以通過Python SDK API管理設備標簽。

SDK使用

• 版本需求

  Aliyun IoT Python SDK version >= 1.0.1

• 更新標簽

  通過thing_update_tags的接口可以添加以及更新標簽，示例如下：

  tags = {
      "floor": "2f",
      "room": "201"
  }
  rc, request_id = linkkit.thing_update_tags(tags)
  if rc == 0:
     printf("success")
       

  該接口異步向云平臺提交一個更新標簽的請求，返回rc和request_id。rc為0時表示成功，request_id為請求ID，可以在異步的回調函數中通過該ID獲取最終的結果。

  執行結果將異步返回，可以通過設置回調函數on_thing_device_info_update 獲得相關結果，示例如下：

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

  標簽更新成功可以在控制臺查看，如下圖所示：

• 刪除標簽

  通過thing_remove_tags的接口可刪除標簽，示例如下：

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

  該接口異步向云平臺提交一個刪除標簽的請求，返回rc和request_id。rc為0時表示成功，request_id為請求ID，可以在異步的回調函數中通過該ID獲取最終的結果。

  執行結果將異步返回，可以通過設置回調函數on_thing_device_info_delete獲得相關結果，示例如下：

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