设备接入 IOTDA-创建设备:响应参数
响应参数
状态码: 201
参数 |
参数类型 |
描述 |
---|---|---|
app_id |
String |
资源空间ID。 最大长度:36 |
app_name |
String |
资源空间名称。 |
device_id |
String |
设备ID,用于唯一标识一个设备。在注册设备时直接指定,或者由 物联网平台 分配获得。由物联网平台分配时,生成规则为"product_id" + "_" + "node_id"拼接而成。 |
node_id |
String |
设备标识码,通常使用IMEI、MAC地址或Serial No作为node_id。 |
gateway_id |
String |
网关ID,用于标识设备所属的父设备,即父设备的设备ID。当设备是直连设备时,gateway_id与设备的device_id一致。当设备是非直连设备时,gateway_id为设备所关联的父设备的device_id。 |
device_name |
String |
设备名称。 |
node_type |
String |
设备节点类型。
|
description |
String |
设备的描述信息。 |
fw_version |
String |
设备的固件版本。 |
sw_version |
String |
设备的软件版本。 |
device_sdk_version |
String |
设备的sdk信息。 |
auth_info |
AuthInfoRes object |
设备的接入认证信息。 |
product_id |
String |
设备关联的产品ID,用于唯一标识一个产品模型。 |
product_name |
String |
设备关联的产品名称。 |
status |
String |
设备的状态。
|
create_time |
String |
在物联网平台注册设备的时间。格式:yyyyMMdd'T'HHmmss'Z',如20151212T121212Z。 |
connection_status_update_time |
String |
设备最近一次连接状态(ONLINE:在线,OFFLINE:离线,ABNORMAL:异常)变化时间。格式:yyyy-MM-dd'T'HH:mm:ss.SSS'Z' ,如2015-12-12T12:12:122Z。 |
active_time |
String |
设备激活时间。格式:yyyy-MM-dd'T'HH:mm:ss.SSS'Z' ,如2015-12-12T12:12:122Z。 |
tags |
Array of TagV5DTO objects |
设备的标签列表。 |
extension_info |
Object |
设备扩展信息。用户可以自定义任何想要的扩展信息,如果在创建设备时为子设备指定该字段,将会通过MQTT接口“平台通知网关子设备新增“将该信息通知给网关。 |
参数 |
参数类型 |
描述 |
---|---|---|
auth_type |
String |
参数说明:鉴权类型。注意:不填写auth_type默认为密钥认证接入方式(SECRET)。 取值范围:
|
secret |
String |
参数说明:设备密钥,认证类型使用密钥认证接入(SECRET)可填写该字段。注意:NB设备密钥由于协议特殊性,只支持十六进制密钥接入;查询设备列表接口不返回该参数。 取值范围:长度不低于8不超过32,只允许字母、数字、下划线(_)、连接符(-)的组合。 最小长度:8 最大长度:32 |
secondary_secret |
String |
参数说明:设备备用密钥,认证类型使用密钥认证接入(SECRET)该字段有效,当主密钥校验不通过时,会启用辅密钥校验,辅密钥与主密钥有相同的效力;辅密钥对coap协议接入的设备不生效。注意:NB设备密钥由于协议特殊性,只支持十六进制密钥接入;查询设备列表接口不返回该参数。 取值范围:长度不低于8不超过32,只允许字母、数字、下划线(_)、连接符(-)的组合。 最小长度:8 最大长度:32 |
fingerprint |
String |
参数说明:证书指纹,认证类型使用证书认证接入(CERTIFICATES)该字段有效,注册设备时不填写该字段则取第一次设备接入时的证书指纹。 取值范围:长度为40的十六进制字符串或者长度为64的十六进制字符串。 |
secondary_fingerprint |
String |
参数说明:证书备用指纹,认证类型使用证书认证接入(CERTIFICATES)该字段有效,当主指纹校验不通过时,会启用辅指纹校验,辅指纹与主指纹有相同的效力。 取值范围:长度为40的十六进制字符串或者长度为64的十六进制字符串。 |
secure_access |
Boolean |
参数说明:指设备是否通过安全协议方式接入。 取值范围:
缺省值:true |
timeout |
Integer |
参数说明:设备接入的有效时间,单位:秒,默认值:0 若设备在有效时间内未接入物联网平台并激活,则平台会删除该设备的注册信息。若设置为“0”,则表示平台不会删除该设备的注册信息(建议填写为“0”)。 注意:该参数只对直连设备生效。 最小值:0 最大值:2147483647 缺省值:0 |