644
魔獸
設備注冊__接口列表_服務器端API_阿裏雲物聯網套件-阿裏雲
描述
本接口為 2016-05-30版本新發布接口。使用場景:用戶通過服務器端生成設備。目前隻支持單個設備生成。
請求參數
名稱 | 類型 | 是否必須 | 描述 |
---|---|---|---|
<公共參數> | 見 公共參數 | ||
ProductKey | String | 是 | 產品的product AppKey |
DeviceName | String | 否 | 自定義設備名稱,不傳則由係統生成默認與deviceId一致 |
返回參數
名稱 | 類型 | 描述 |
---|---|---|
RequestId | String | 當前請求在阿裏雲產生的請求ID |
Success | Boolean | 表示調用成功與否 |
ErrorMessage | String | 錯誤信息 |
DeviceId | String | 阿裏雲頒發的設備id,全局唯一 |
DeviceName | String | 設備名稱,產品內唯一,由用戶自定義,如果重複將返回已有產品,如果不指定則返回deviceId |
DeviceSecret | String | 設備私鑰 |
DeviceStatus | String | 設備狀態,目前預留 |
示例
- 請求示例
https://iot.aliyuncs.com/?&Action=RegistDevice
&ProductKey=...
&<[公共請求參數]>
SDK示例代碼 [SDK下載]
java
RegistDeviceRequest request = new RegistDeviceRequest();
request.setProductKey("xxxxxx");
request.setDeviceName("xxxxx");//可以設空,如果名稱為空則由阿裏雲生成設備名稱默認與設備id一致。設備名稱在產品內唯一,如果已存在則返回已有設備
RegistDeviceResponse resp = client.getAcsResponse(request);
System.out.println(resp.getSuccess());
System.out.println(resp.getErrorMessage());
System.out.println(resp.getDeviceSecret());
System.out.println(resp.getDeviceId());
System.out.println(resp.getDeviceName());
php
python
request = RegistDeviceRequest.RegistDeviceRequest()
request.set_accept_format('json') // 設置返回數據格式,默認為XML
request.set_ProductKey('xxxxxxx')
request.set_DeviceName('xxxxxxx') // 可以設空,如果名稱為空則由阿裏雲生成設備名稱默認與設備id一致。設備名稱在產品內唯一,如果已存在則返回已有設備
result = clt.do_action(request)
print 'regist device : ' + result
返回示例
json示例
{
"RequestId":"120F5EB3-7023-4F0C-B419-9303AB336885",
"Success":true
"DeviceId":"", //阿裏雲頒發的設備id 全局唯一
"DeviceName":"",//設備名稱,用戶自定義或係統生成
"DeviceSecret":"",//設備私鑰
"DeviceStatus":"",//預留狀態字段
"ErrorMessage":""//錯誤信息
}
常見錯誤
未授權操作
這種錯誤信息一般是由於 調用SDK時候,填寫的accessKeyId和accessSecret與你指定的productKey的創建者不是用一個用戶導致的。 注冊設備的時候,需要使用當前ProductKey的創建者對應的accessKey和accessSecret才有效.
最後更新:2016-12-06 17:27:48
上一篇:
查詢產品的設備列表__接口列表_服務器端API_阿裏雲物聯網套件-阿裏雲
下一篇:
申請批量生成設備__接口列表_服務器端API_阿裏雲物聯網套件-阿裏雲
命令終端的使用方法__命令終端_用戶指南(Linux)_數據管理-阿裏雲
HSF 特性使用__服務開發_開發者指南_企業級分布式應用服務 EDAS-阿裏雲
GetLogs__日誌庫相關接口_API-Reference_日誌服務-阿裏雲
刪除安全組__安全組_用戶指南_雲服務器 ECS-阿裏雲
個人實名認證和企業實名認證的區別__實名認證_帳號實名認證_會員賬號&實名認證-阿裏雲
預熱緩存__刷新預熱接口_API 手冊_CDN-阿裏雲
阿裏雲全球化邁入2.0階段,或將助推阿裏取得更大突破
查看慢日誌列表__日誌管理_API 參考_雲數據庫 RDS 版-阿裏雲
分區設計__最佳實踐_雲數據庫 PetaData-阿裏雲
推送使用場景__最佳實踐_移動推送-阿裏雲
相關內容
常見錯誤說明__附錄_大數據計算服務-阿裏雲
發送短信接口__API使用手冊_短信服務-阿裏雲
接口文檔__Android_安全組件教程_移動安全-阿裏雲
運營商錯誤碼(聯通)__常見問題_短信服務-阿裏雲
設置短信模板__使用手冊_短信服務-阿裏雲
OSS 權限問題及排查__常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲
消息通知__操作指南_批量計算-阿裏雲
設備端快速接入(MQTT)__快速開始_阿裏雲物聯網套件-阿裏雲
查詢API調用流量數據__API管理相關接口_API_API 網關-阿裏雲
使用STS訪問__JavaScript-SDK_SDK 參考_對象存儲 OSS-阿裏雲