物聯網平台的標籤功能 - IoT Platform

物聯網平台提供標籤功能，支援使用自訂標籤來標識產品、裝置或分組，實現從不同維度將具有相同特性的裝置歸類，便於搜尋、彙總裝置資源，以便更靈活管理物聯網平台裝置。本文介紹標籤的具體使用方法。

使用說明

標籤	說明
產品標籤	用於描述同一個產品下所有裝置所具有的共性資訊。例如：使用產品的製造商、所屬單位、外觀尺寸、作業系統等標記產品。
裝置標籤	根據裝置的特性為裝置添加特有的標籤，方便統計並歸類一批裝置進行彙總展示和管理。例如，為房間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。

對話方塊中包含地理位置標籤（鍵名為 coordinate，值通過下拉框選擇座標資訊，可單擊重設恢複預設）和裝置標籤（自訂索引值對，如鍵名 room、值 101，可單擊刪除移除該標籤）。

參數	說明
標籤Key	可包含英文字母、數字、正斜線（/）、底線（_）、短劃線（-）、井號（#）、at（@）、百分比符號（%）、and（&）、星號（*）和英文句號（.），長度不超過30個字元。
標籤Value	可包含中文、英文字母、數字、日文、底線（_）和短劃線（-）、井號（#）、at（@）、百分比符號（%）、and（&）、英文冒號（:）和英文句號（.），長度不超過128個字元，一個中文或日文佔2個字元。

（可選）您可單擊新增標籤，添加多對標籤，也可單擊刪除，刪除無用的標籤。
單擊確認。

編輯分組標籤

在目標執行個體的左側導覽列，選擇裝置管理 > 分組。
在分組頁面，找到需要添加標籤的分組，並單擊對應操作欄中的查看。

分組標籤地區，展示當前分組下所有的標籤資訊。
單擊標籤資訊右側的編輯。

在編輯標籤對話方塊中，輸入標籤的標籤Key和標籤Value。

單擊刪除可移除已有標籤行，單擊 + 新增標籤 可添加新的標籤行。

參數	說明
標籤Key	可包含英文字母、數字和英文句號（.），長度不超過30個字元。
標籤Value	可包含中文、英文字母、數字、日文、底線（_）、短劃線（-）、英文冒號（:）和英文句號（.），長度不超過128個字元，一個中文或日文佔2個字元。

（可選）您可單擊新增標籤，添加多對標籤，也可單擊刪除，刪除無用的標籤。
單擊確認。

通過雲端API大量操作標籤

物聯網平台提供了雲端API來批量管理標籤，或根據標籤來查詢產品、裝置和分組。

產品標籤

功能	API	描述
編輯標籤	CreateProductTags	建立產品標籤。
	UpdateProductTags	更新產品標籤。
	DeleteProductTags	刪除產品標籤。
查看標籤	ListProductTags	查詢產品的所有標籤。
使用標籤	ListProductByTags	根據標籤查詢產品。

裝置標籤

功能	API	描述
編輯標籤	SaveDeviceProp	設定裝置標籤。
編輯標籤	DeleteDeviceProp	刪除裝置標籤。
查詢標籤	QueryDeviceProp	查詢指定裝置下的標籤列表。
使用標籤	QueryDeviceByTags	根據標籤查詢裝置。

分組標籤

功能	API	描述
編輯標籤	SetDeviceGroupTags	添加、更新或刪除分組標籤。
查詢標籤	QueryDeviceGroupTagList	查詢分組標籤列表。
使用標籤	QueryDeviceGroupByTags	根據標籤查詢裝置分組。