上一篇文章将産品和産品标簽相關的操作都介紹完了,這次我們轉向介紹裝置的相關操作。裝置對于産品來說,可以了解為一個從抽象到具體的過
程,因為産品是一個大的概念,不具備可操作的可能性;隻有在一個産品下面,再繼續建立裝置,然後對這個裝置進行相關的操作,才可以有具體
的實體意義;也正是由于隻有裝置才可以讓使用者感覺到雲端服務的真正落地實施,和使用者的具體裝置相關聯,是以在阿裡雲iot種類數量繁多的api
接口中,裝置管理類的數量最多,估計有三四十個,應該是占據了IOT服務段API接口的半壁江山了;由于數量功能太多,一次應該介紹不完,是以
這一次,我們先來介紹下一些裝置的基本操作,估計大概有5,6個接口吧;
當然使用的實踐驗證工具是最新的XYsuger軟體,下載下傳連接配接如下:
http://xysuger.xunyun17.xyz/v0.0.4.rar第一個接口要數建立裝置了,畢竟裝置不可能憑空出現,需要我們調用相應的接口,才可以在雲端建立一個裝置,在阿裡雲的iot體系結構裡,不
存在建立裝置的概念,而隻有注冊裝置的接口名稱,筆者的了解是,從雲端的角度來看,隻是提供一個允許各種裝置接入的操作,而建立裝置是指
制造出一個實實在在的看得着,摸得到的東東,這個過程應該屬于制造業領域的範疇,畢竟社會各行各業都有很多分工嘛,是以注冊裝置這個接口
名稱也應該比較好了解吧;因為裝置是屬于某一類産品下面的,是以如果要注冊裝置的話,就要先提供給服務端産品的關鍵字,友善服務端知道要
建立的裝置是應該屬于哪個産品裡面的;是以我們先用以前提到的查詢産品接口,得到一個産品的關鍵字,操作指令如下:
XYsayFrO.IoT.Srv.QueryProductList.
得到結果如下:
我們可以看到,目前一共有8個産品,我們就用第一個産品的關鍵字a17hjshDgiK,作為本次裝置介紹的實踐示範;再回到剛才說的注冊裝置的接口
,這個接口的名字是RegisterDevice,後面帶兩個參數,一個是産品的關鍵字,一個是注冊裝置的名字,例如我們要注冊一個燈的裝置,指令如下
:
XYsayFrO.IoT.Srv.RegisterDevice.a17hjshDgiK.lamp_dev1.
運作成功後,會出現如下圖所示資訊,傳回結果裡一般有四個資訊:
ProductKey和DeviceName,這個讀者應該好了解,因為就是在調用注冊裝置前,我們傳給這個接口的參數;DeviceSecret是用來裝置端正常運作後
,連到雲端的一個參數,目前對于雲端的操作,暫時還用不到;最後一個IotId是裝置的物聯網識别号,這個是整個阿裡雲IOT系統裡,唯一的識别
号,也就是說可以跨過或忽略産品的關鍵字,對裝置的操作直接提供這個裝置的物聯網識别号,就可以在雲端操作啦。這個可以IotId啊,看到這
個詞,估計有不少讀者朋友會和筆者一樣,感到瞬間秒變高大上了,畢竟感覺挺這就比什麼産品名稱,裝置名稱上檔次。。。
第一個接口介紹完,就該開始介紹第二個接口了,第二個接口是查詢裝置的詳細資訊,我們可以通過下面的指令查詢下,剛才我們注冊裝置的具體
資訊:
XYsayFrO.IoT.Srv.QueryDeviceDetail.IinyD6NrRkdfV2PhkCn7000000.
運作後,結果如下圖:
這裡對比第一個接口的傳回結果,region,status和建立時間的資訊;目前注冊好的裝置區域預設是上海,狀态預設是未激活;
第三個接口還是注冊裝置相關的,不過是批量注冊裝置,這個接口估計以後未來會非常非常有用
。因為物聯網iot通常被宣傳為上億規模的産業,是以要接入雲端的裝置今後會非常非常的多,這要是使用第一個接口,一個一個注冊裝置,不僅
費時,也浪費網絡帶寬,那是多麼不環保啊。是以就引出了下面批量注冊裝置的指令,
XYsayFrO.IoT.Srv.BatchRegisterDevice.a17hjshDgiK.10.
這次,我們試着在剛才産品關鍵字的下面,再一次性批量的注冊10個裝置。運作成功後,結果如下圖:
這裡多傳回了一個applyid,可以留着以後查詢具體裝置資訊;
批量建立完裝置後,我們可以通過下面的指令,來查詢一個産品下面有多少個裝置和每個裝置的具體資訊:
XYsayFrO.IoT.Srv.QueryDevice.a17hjshDgiK.
查詢成功後,如下圖所示:
在這裡,我們可以看到,我們第一個注冊裝置和後面批量注冊10個裝置,一共是11裝置。每個裝置的物聯網識别号,建立時間和目前狀态一目了然
;
注冊,查詢裝置都介紹了,我們再來看下删除裝置的操作,前面提到對裝置的操作,隻要有物聯網識别号,就是可以跨過産品的相關資訊,直接對
對裝置進行相關操作的,是以這裡我們隻提供一個物聯網識别号碼,來分别删除我們剛才建立的裝置:
XYsayFrO.IoT.Srv.DeleteDevice.5rFxCUgQy3UAiZtlVmNx000000
XYsayFrO.IoT.Srv.DeleteDevice.tLtNBR1FBdaNqqubClcq000000.
XYsayFrO.IoT.Srv.DeleteDevice.wCIWzNky7DxCe4oXuORW000000.
XYsayFrO.IoT.Srv.DeleteDevice.xgpNt5S7NxULyb3yyqg2000000.
XYsayFrO.IoT.Srv.DeleteDevice.zplhKmYsdzhHRZtOAj7y000000.
當運作後,傳回如下資訊,表示這五個裝置都已經被我們删除了;
為了確定删除無誤,我們也可以通過再次查詢産品下的裝置資訊,來驗證我們是否真正删除了這五個裝置;
這是傳回如下資訊:
我們在批量注冊完裝置的時候,第一次查詢的是11個裝置,現在提示是6個裝置,是以這也表示我們剛才删除的5個裝置的操作是成功;這就表示我們确實把剛才建立的四個标簽删除掉了;
光陰似箭,時間飛逝,不知不覺這次關于裝置的基本操作也就介紹完了。後續如有可能,會介紹一些裝置的其他類别的操作。