设备接入 IOTDA-修改设备:请求参数
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
参数说明:用户Token。通过调用 IAM 服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 |
Instance-Id |
否 |
String |
参数说明:实例ID。物理多租下各实例的唯一标识,建议携带该参数,在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面,选择左侧导航栏“总览”页签查看当前实例的ID,具体获取方式请参考查看实例详情 。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
device_name |
否 |
String |
参数说明:设备名称,资源空间下唯一,用于资源空间下唯一标识一个设备。 取值范围:长度不超过256,只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合,建议不少于4个字符。 最小长度:1 最大长度:256 |
description |
否 |
String |
参数说明:设备的描述信息。 取值范围:长度不超过2048,只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合 最大长度:2048 |
extension_info |
否 |
Object |
参数说明:设备扩展信息。用户可以自定义任何想要的扩展信息,修改子设备信息时不会下发给网关。 |
auth_info |
否 |
AuthInfoWithoutSecret object |
参数说明:设备的接入认证信息。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
secure_access |
否 |
Boolean |
参数说明:指设备是否通过安全协议方式接入。 取值范围:
缺省值:true |
timeout |
否 |
Integer |
参数说明:设备接入的有效时间,单位:秒,默认值:0。若设备在有效时间内未接入 物联网平台 并激活,则平台会删除该设备的注册信息。若设置为“0”,则表示平台不会删除该设备的注册信息(建议填写为“0”)。 注意:该参数只对直连设备生效 最小值:0 最大值:2147483647 缺省值:0 |