標(biāo)簽
物聯(lián)網(wǎng)平臺(tái)提供標(biāo)簽功能,支持使用自定義標(biāo)簽來標(biāo)識(shí)產(chǎn)品、設(shè)備或分組,實(shí)現(xiàn)從不同維度將具有相同特性的設(shè)備歸類,便于搜索、聚合設(shè)備資源,以便更靈活管理物聯(lián)網(wǎng)平臺(tái)設(shè)備。本文介紹標(biāo)簽的具體使用方法。
使用說明
標(biāo)簽 | 說明 |
產(chǎn)品標(biāo)簽 | 用于描述同一個(gè)產(chǎn)品下所有設(shè)備所具有的共性信息。 例如:使用產(chǎn)品的制造商、所屬單位、外觀尺寸、操作系統(tǒng)等標(biāo)記產(chǎn)品。 |
設(shè)備標(biāo)簽 | 根據(jù)設(shè)備的特性為設(shè)備添加特有的標(biāo)簽,方便統(tǒng)計(jì)并歸類一批設(shè)備進(jìn)行聚合展示和管理。 例如,為房間201的智能電表定義一個(gè)標(biāo)簽為 |
分組標(biāo)簽 | 用于跨產(chǎn)品管理設(shè)備,描述一個(gè)分組下所有設(shè)備和子分組所具有的共性信息。 例如:分組下的設(shè)備所在地域、空間等。 |
應(yīng)用場景
通過標(biāo)簽批量操作
標(biāo)簽 | 操作示例 |
產(chǎn)品標(biāo)簽 | 根據(jù)標(biāo)簽信息查找物聯(lián)網(wǎng)平臺(tái)對(duì)應(yīng)實(shí)例下的共性產(chǎn)品。 |
設(shè)備標(biāo)簽 | 根據(jù)標(biāo)簽信息搜索目標(biāo)設(shè)備后,可批量操作:
|
分組標(biāo)簽 | 根據(jù)標(biāo)簽信息查找物聯(lián)網(wǎng)平臺(tái)對(duì)應(yīng)實(shí)例下的具有共性的分組或子分組。 |
設(shè)備端批量操作標(biāo)簽信息
在設(shè)備端完成標(biāo)簽管理功能開發(fā)后,設(shè)備端支持管理標(biāo)簽信息:
上報(bào)標(biāo)簽:設(shè)備上報(bào)標(biāo)簽信息后,在物聯(lián)網(wǎng)平臺(tái)控制臺(tái)對(duì)應(yīng)設(shè)備中自動(dòng)添加或更新對(duì)應(yīng)標(biāo)簽信息。
刪除標(biāo)簽:設(shè)備發(fā)送刪除標(biāo)簽的請(qǐng)求,物聯(lián)網(wǎng)平臺(tái)收到請(qǐng)求后,會(huì)刪除對(duì)應(yīng)標(biāo)簽信息。
獲取標(biāo)簽信息:設(shè)備發(fā)送獲取標(biāo)簽信息的請(qǐng)求,物聯(lián)網(wǎng)平臺(tái)收到請(qǐng)求后,返回對(duì)應(yīng)標(biāo)簽信息。
在物聯(lián)網(wǎng)平臺(tái)提供多語言的設(shè)備端Link SDK已集成標(biāo)簽功能,使設(shè)備標(biāo)簽信息跟隨設(shè)備在物聯(lián)網(wǎng)平臺(tái)系統(tǒng)內(nèi)部流轉(zhuǎn)。設(shè)備端Link SDK代碼示例,請(qǐng)參見設(shè)備開發(fā)的設(shè)備標(biāo)簽。管理標(biāo)簽信息的Topic和數(shù)據(jù)格式,請(qǐng)參見設(shè)備標(biāo)簽的Alink協(xié)議。
服務(wù)端訂閱或通過云產(chǎn)品流轉(zhuǎn)設(shè)備標(biāo)簽變更信息
物聯(lián)網(wǎng)平臺(tái)可基于消息轉(zhuǎn)發(fā)的數(shù)據(jù)流轉(zhuǎn)功能,將設(shè)備標(biāo)簽操作(添加、更新、刪除、清空)添加到設(shè)備上報(bào)的消息體里,并發(fā)送給業(yè)務(wù)服務(wù)器或其它阿里云產(chǎn)品。數(shù)據(jù)流轉(zhuǎn)配置,請(qǐng)參見消息轉(zhuǎn)發(fā)。流轉(zhuǎn)的數(shù)據(jù)格式,請(qǐng)參見設(shè)備標(biāo)簽變更。
前提條件
添加標(biāo)簽前,需先對(duì)應(yīng)完成產(chǎn)品、設(shè)備或分組的創(chuàng)建。具體操作,請(qǐng)參見:
背景信息
物聯(lián)網(wǎng)涉及量級(jí)產(chǎn)品與設(shè)備的管理。如何區(qū)分不同批次的產(chǎn)品與設(shè)備、如何實(shí)現(xiàn)批量管理,成為一大挑戰(zhàn)。阿里云物聯(lián)網(wǎng)平臺(tái)為解決這一問題提供了標(biāo)簽功能。您可以為不同產(chǎn)品、設(shè)備或設(shè)備分組貼上不同標(biāo)簽,然后根據(jù)標(biāo)簽實(shí)現(xiàn)分類統(tǒng)一管理。
使用限制
產(chǎn)品標(biāo)簽、設(shè)備標(biāo)簽和分組標(biāo)簽的結(jié)構(gòu)為
Key:Value
。abc
為物聯(lián)網(wǎng)平臺(tái)系統(tǒng)保留的標(biāo)簽Key
,即標(biāo)簽Key
不能設(shè)置為abc。若設(shè)置Key=abc
,使用標(biāo)簽檢索時(shí)會(huì)直接被過濾。標(biāo)簽
Key
中的英文字符大小寫不敏感,但物聯(lián)網(wǎng)平臺(tái)系統(tǒng)內(nèi)部以及消息轉(zhuǎn)發(fā)流轉(zhuǎn)的標(biāo)簽信息中,會(huì)一直使用首次添加標(biāo)簽信息中的Key
字段。即使刪除標(biāo)簽,重新添加標(biāo)簽僅修改英文大小寫,流轉(zhuǎn)的標(biāo)簽信息中
Key
也仍然使用刪除前首次設(shè)置該標(biāo)簽信息中的Key
。例如:設(shè)置標(biāo)簽
ssid:1000
,后續(xù)更新標(biāo)簽使用Ssid:1001
,可以更新Value
成功,但系統(tǒng)內(nèi)容流轉(zhuǎn)的數(shù)據(jù)格式中仍然使用ssid:1001
。每個(gè)產(chǎn)品、設(shè)備或分組最多可有100個(gè)標(biāo)簽。
在控制臺(tái)編輯標(biāo)簽
編輯產(chǎn)品標(biāo)簽
在實(shí)例概覽頁簽的全部環(huán)境下,找到對(duì)應(yīng)的實(shí)例,單擊實(shí)例卡片。
在左側(cè)導(dǎo)航欄,選擇 。
在產(chǎn)品頁面,找到需要添加標(biāo)簽的產(chǎn)品,并單擊對(duì)應(yīng)操作欄中的查看。
標(biāo)簽信息區(qū)域,展示當(dāng)前產(chǎn)品下所有的標(biāo)簽信息。
單擊標(biāo)簽信息右側(cè)的編輯。
在編輯標(biāo)簽對(duì)話框中,輸入標(biāo)簽的標(biāo)簽Key和標(biāo)簽Value。
參數(shù)
說明
標(biāo)簽Key
可包含英文字母、數(shù)字和英文句號(hào)(.),長度不超過30個(gè)字符。
標(biāo)簽Value
可包含中文、英文字母、數(shù)字、日文、下劃線(_)、短劃線(-)、英文冒號(hào)(:)和英文句號(hào)(.),長度不超過128個(gè)字符,一個(gè)中文或日文占2個(gè)字符。
(可選)您可單擊新增標(biāo)簽,添加多對(duì)標(biāo)簽,也可單擊刪除,刪除無用的標(biāo)簽。
單擊確認(rèn)。
編輯設(shè)備標(biāo)簽
在目標(biāo)實(shí)例的左側(cè)導(dǎo)航欄,選擇 。
在設(shè)備頁面,單擊要添加標(biāo)簽的設(shè)備所對(duì)應(yīng)的查看。
標(biāo)簽信息區(qū)域,展示當(dāng)前設(shè)備下所有的標(biāo)簽信息。
在設(shè)備詳情頁面,單擊標(biāo)簽信息右側(cè)的編輯。
在編輯標(biāo)簽對(duì)話框中,單擊新增標(biāo)簽,輸入標(biāo)簽的標(biāo)簽Key和標(biāo)簽Value。
參數(shù)
說明
標(biāo)簽Key
可包含英文字母、數(shù)字、正斜線(/)、下劃線(_)、短劃線(-)、井號(hào)(#)、at(@)、百分號(hào)(%)、and(&)、星號(hào)(*)和英文句號(hào)(.),長度不超過30個(gè)字符。
標(biāo)簽Value
可包含中文、英文字母、數(shù)字、日文、下劃線(_)和短劃線(-)、井號(hào)(#)、at(@)、百分號(hào)(%)、and(&)、英文冒號(hào)(:)和英文句號(hào)(.),長度不超過128個(gè)字符,一個(gè)中文或日文占2個(gè)字符。
可選:在編輯標(biāo)簽對(duì)話框中,單擊地理位置標(biāo)簽的文本框,在彈出的地圖中選擇位置,可以按地址搜索。
重要地理位置標(biāo)簽用于標(biāo)記設(shè)備的地理位置,結(jié)構(gòu)為
coordinate: ${經(jīng)度}:${緯度}
。如果設(shè)備所屬產(chǎn)品的物模型包含GeoLocation屬性,在控制臺(tái)設(shè)置地理位置標(biāo)簽后,該地理位置信息將同步為GeoLocation屬性值。但通過云端API和設(shè)備上報(bào)設(shè)置的地理位置標(biāo)簽信息,不會(huì)同步到GeoLocation屬性。
(可選)您可單擊新增標(biāo)簽,添加多對(duì)標(biāo)簽,也可單擊刪除,刪除無用的標(biāo)簽。
單擊確認(rèn)。
編輯分組標(biāo)簽
在目標(biāo)實(shí)例的左側(cè)導(dǎo)航欄,選擇 。
在分組頁面,找到需要添加標(biāo)簽的分組,并單擊對(duì)應(yīng)操作欄中的查看。
分組標(biāo)簽區(qū)域,展示當(dāng)前分組下所有的標(biāo)簽信息。
單擊標(biāo)簽信息右側(cè)的編輯。
可選:在編輯標(biāo)簽對(duì)話框中,單擊地理位置標(biāo)簽的文本框,在彈出的地圖中選擇位置,可以按地址搜索。
說明地理位置標(biāo)簽用于標(biāo)記設(shè)備的地理位置,結(jié)構(gòu)為
coordinate: ${經(jīng)度}:${緯度}
。在編輯標(biāo)簽對(duì)話框中,輸入標(biāo)簽的標(biāo)簽Key和標(biāo)簽Value。
參數(shù)
說明
標(biāo)簽Key
可包含英文字母、數(shù)字和英文句號(hào)(.),長度不超過30個(gè)字符。
標(biāo)簽Value
可包含中文、英文字母、數(shù)字、日文、下劃線(_)、短劃線(-)、英文冒號(hào)(:)和英文句號(hào)(.),長度不超過128個(gè)字符,一個(gè)中文或日文占2個(gè)字符。
(可選)您可單擊新增標(biāo)簽,添加多對(duì)標(biāo)簽,也可單擊刪除,刪除無用的標(biāo)簽。
單擊確認(rèn)。
通過云端API批量操作標(biāo)簽
物聯(lián)網(wǎng)平臺(tái)提供了云端API來批量管理標(biāo)簽,或根據(jù)標(biāo)簽來查詢產(chǎn)品、設(shè)備和分組。
產(chǎn)品標(biāo)簽
功能 | API | 描述 |
編輯標(biāo)簽 | 創(chuàng)建產(chǎn)品標(biāo)簽。 | |
更新產(chǎn)品標(biāo)簽。 | ||
刪除產(chǎn)品標(biāo)簽。 | ||
查看標(biāo)簽 | 查詢產(chǎn)品的所有標(biāo)簽。 | |
使用標(biāo)簽 | 根據(jù)標(biāo)簽查詢產(chǎn)品。 |
設(shè)備標(biāo)簽
功能 | API | 描述 |
編輯標(biāo)簽 | 設(shè)置設(shè)備標(biāo)簽。 | |
刪除設(shè)備標(biāo)簽。 | ||
查詢標(biāo)簽 | 查詢指定設(shè)備下的標(biāo)簽列表。 | |
使用標(biāo)簽 | 根據(jù)標(biāo)簽查詢?cè)O(shè)備。 |
分組標(biāo)簽
功能 | API | 描述 |
編輯標(biāo)簽 | 添加、更新或刪除分組標(biāo)簽。 | |
查詢標(biāo)簽 | 查詢分組標(biāo)簽列表。 | |
使用標(biāo)簽 | 根據(jù)標(biāo)簽查詢?cè)O(shè)備分組。 |