设备接入 IOTDA-修改设备:请求参数

时间:2024-06-28 09:24:45

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数说明:用户Token。通过调用 IAM 服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证

Instance-Id

String

参数说明:实例ID。物理多租下各实例的唯一标识,建议携带该参数,在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面,选择左侧导航栏“总览”页签查看当前实例的ID,具体获取方式请参考查看实例详情

表3 请求Body参数

参数

是否必选

参数类型

描述

device_name

String

参数说明:设备名称,资源空间下唯一,用于资源空间下唯一标识一个设备。 取值范围:长度不超过256,只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合,建议不少于4个字符。

最小长度:1

最大长度:256

description

String

参数说明:设备的描述信息。 取值范围:长度不超过2048,只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合

最大长度:2048

extension_info

Object

参数说明:设备扩展信息。用户可以自定义任何想要的扩展信息,修改子设备信息时不会下发给网关。

auth_info

AuthInfoWithoutSecret object

参数说明:设备的接入认证信息。

表4 AuthInfoWithoutSecret

参数

是否必选

参数类型

描述

secure_access

Boolean

参数说明:指设备是否通过安全协议方式接入。 取值范围

  • true:通过安全协议方式接入。

  • false:通过非安全协议方式接入。非安全接入的设备存在被仿冒等安全风险,请谨慎使用。

缺省值:true

timeout

Integer

参数说明:设备接入的有效时间,单位:秒,默认值:0。若设备在有效时间内未接入 物联网平台 并激活,则平台会删除该设备的注册信息。若设置为“0”,则表示平台不会删除该设备的注册信息(建议填写为“0”)。 注意:该参数只对直连设备生效

最小值:0

最大值:2147483647

缺省值:0

support.huaweicloud.com/api-iothub/iot_06_v5_1079.html