物聯網平臺提供標簽功能,支持使用自定義標簽來標識產品、設備或分組,實現從不同維度將具有相同特性的設備歸類,便于搜索、聚合設備資源,以便更靈活管理物聯網平臺設備。本文介紹標簽的具體使用方法。
使用說明
標簽 | 說明 |
產品標簽 | 用于描述同一個產品下所有設備所具有的共性信息。 例如:使用產品的制造商、所屬單位、外觀尺寸、操作系統等標記產品。 |
設備標簽 | 根據設備的特性為設備添加特有的標簽,方便統計并歸類一批設備進行聚合展示和管理。 例如,為房間201的智能電表定義一個標簽為 |
分組標簽 | 用于跨產品管理設備,描述一個分組下所有設備和子分組所具有的共性信息。 例如:分組下的設備所在地域、空間等。 |
應用場景
通過標簽批量操作
標簽 | 操作示例 |
產品標簽 | 根據標簽信息查找物聯網平臺對應實例下的共性產品。 |
設備標簽 | 根據標簽信息搜索目標設備后,可批量操作: |
分組標簽 | 根據標簽信息查找物聯網平臺對應實例下的具有共性的分組或子分組。 |
設備端批量操作標簽信息
在設備端完成標簽管理功能開發后,設備端支持管理標簽信息:
上報標簽:設備上報標簽信息后,在物聯網平臺控制臺對應設備中自動添加或更新對應標簽信息。
刪除標簽:設備發送刪除標簽的請求,物聯網平臺收到請求后,會刪除對應標簽信息。
獲取標簽信息:設備發送獲取標簽信息的請求,物聯網平臺收到請求后,返回對應標簽信息。
在物聯網平臺提供多語言的設備端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 | 描述 |
編輯標簽 | 創建產品標簽。 | |
更新產品標簽。 | ||
刪除產品標簽。 | ||
查看標簽 | 查詢產品的所有標簽。 | |
使用標簽 | 根據標簽查詢產品。 |
設備標簽
功能 | API | 描述 |
編輯標簽 | 設置設備標簽。 | |
刪除設備標簽。 | ||
查詢標簽 | 查詢指定設備下的標簽列表。 | |
使用標簽 | 根據標簽查詢設備。 |
分組標簽
功能 | API | 描述 |
編輯標簽 | 添加、更新或刪除分組標簽。 | |
查詢標簽 | 查詢分組標簽列表。 | |
使用標簽 | 根據標簽查詢設備分組。 |