如果您需要同時設定多個裝置的屬性值,可以使用物聯網平台的裝置批量屬性設定任務。本文介紹該任務的建立方法、運行中Topic及其資料格式的說明,查看狀態的具體操作。
前提條件
任務管理流程
- 建立裝置批量屬性設定任務。
- 在物聯網平台控制台對應執行個體下的 頁面,單擊建立任務。
- 在建立任務頁面,單擊以下參數名稱右側的協助表徵圖,根據頁面提示,配置任務和作業。
- 任務配置
參數 說明 任務名稱 輸入符合規則的任務名稱。可自訂。 任務類型 選擇類型:裝置批量屬性設定任務。 任務描述 輸入該任務的用途等資訊,便於您區分不同的任務。 目標裝置、產品或分組 從裝置、產品或分組維度選擇可執行任務的裝置。重要 從分組維度選擇裝置時,不支援選擇動態分組。下發給裝置的任務執行規則 上傳規則檔案。僅支援 .json
格式檔案,檔案大小不能超過64 KB。您可單擊下載模板,擷取規則檔案模板。
例如裝置所屬產品下的物模型屬性溫度,標識符為temperature),資料類型為double,程式碼範例如下:
{ "params": { "temperature": 30.5 } }
- params:屬性設定參數。其下可包含多個屬性。
- temperature、30.5:屬性標識符及對應值。可在物聯網平台控制台,裝置所屬產品的功能定義中查看屬性標識符。
如果是自訂(非預設)模組
testFb
下屬性temperature
,則參數為"testFb:temperature":30.5
。
- 作業配置
參數 說明 作業執行速率配置 根據您的業務需要,設定每分鐘作業推送數量。必選配置。 作業執行的逾時配置 僅對自訂任務生效。此處無需配置。 作業開始調度時間 可選配置。 從當前設定作業的時間,開始計算時間。
裝置任務建立成功後,先初始化,直至到達調度時間,才會開始調度執行。
- 任務配置
- 單擊完成。
- 任務建立完成後,物聯網平台通過調用SetDeviceProperty或SetDevicesProperty介面,下發設定屬性指令到裝置,然後裝置向物聯網平台返迴響應結果。
資料格式(下行)
請求和響應Topic
透傳/自訂
請求Topic:
/sys/${productKey}/${deviceName}/thing/model/down_raw
響應Topic:
/sys/${productKey}/${deviceName}/thing/model/down_raw_reply
Alink JSON
請求Topic:
/sys/${productKey}/${deviceName}/thing/service/property/set
響應Topic:
/sys/${productKey}/${deviceName}/thing/service/property/set_reply
訊息格式如下:
{ "id": "123", "version": "1.0", "params": { "temperature": "30.5" }, "method": "thing.service.property.set" }
其中,params資料是任務規則檔案的params資料。
設定裝置屬性的Alink協議,請參見設定裝置屬性。
- 在物聯網平台對應執行個體下的 頁面,查看已建立任務及目前狀態。重要 狀態為已逾時的任務,不可再被調度執行。
從任務建立完成開始計時,如果任務下作業未在7天內全部執行完成,任務狀態顯示為已逾時。
您可根據實際情境需要,執行以下操作:
- 在工作清單中,取消執行中狀態的任務。
- 單擊目標任務對應的查看,在任務詳情頁面,查看任務資訊和作業執行統計。
功能頁簽 說明 任務資訊 您可以查看任務資訊,修改任務描述和作業配置,下載裝置任務檔案。 作業概覽 您可以查看任務下各狀態的作業統計。 - 您可以單擊目標裝置的查看,在裝置詳情頁面:
- 單擊任務頁簽,查看該裝置下的所有工作清單。
- 單擊Log Service的前往查看,在雲端作業記錄頁簽的搜尋欄,選擇業務類型為雲到裝置訊息,查看裝置任務相關日誌。
- 如果作業未執行成功,單擊執行詳情,可查看失敗原因。
- 如果作業執行已逾時或失敗,單擊已逾時或失敗的狀態按鈕,可查看對應狀態的作業列表。
您可以單擊列表上方的重新執行,重新執行當前任務下所有已逾時和失敗的作業。
- 您可以單擊目標裝置的查看,在裝置詳情頁面:
- 單擊目標任務對應的刪除,然後單擊確認。警告 刪除裝置任務後,與該任務相關的資料被清除,如果有依賴該任務的業務,可能導致服務不可用或影響使用者的業務。請謹慎操作。