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-阿里云