设备接入 IOTDA-灵活搜索设备列表:响应参数

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

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

devices

Array of SearchDevice objects

搜索设备结果列表。

count

Long

满足查询条件的记录总数(只有条件为select count(*)/count(1)时单独返回)。

表5 SearchDevice

参数

参数类型

描述

app_id

String

资源空间ID。

最大长度:36

app_name

String

资源空间名称。

device_id

String

设备ID,用于唯一标识一个设备。在注册设备时直接指定,或者由 物联网平台 分配获得。由物联网平台分配时,生成规则为"product_id" + "_" + "node_id"拼接而成。

最大长度:256

node_id

String

设备标识码,通常使用IMEI、MAC地址或Serial No作为node_id。

最大长度:64

gateway_id

String

网关ID,用于标识设备所属的父设备,即父设备的设备ID。当设备是直连设备时,gateway_id与设备的device_id一致。当设备是非直连设备时,gateway_id为设备所关联的父设备的device_id。

最大长度:256

device_name

String

设备名称。

最大长度:256

node_type

String

设备节点类型。

  • ENDPOINT:非直连设备。

  • GATEWAY:直连设备或网关。

  • UNKNOWN:未知。

fw_version

String

设备的固件版本。

最大长度:256

sw_version

String

设备的软件版本。

最大长度:256

device_sdk_version

String

设备的sdk信息。

最大长度:256

product_id

String

设备关联的产品ID,用于唯一标识一个产品模型。

product_name

String

设备关联的产品名称。

groups

Object

设备组列表。

status

String

设备的状态。

  • ONLINE:设备在线。

  • OFFLINE:设备离线。

  • ABNORMAL:设备异常。

  • INACTIVE:设备未激活。

  • FROZEN:设备冻结。

tags

Object

设备的标签列表。

marker

String

搜索结果记录Id。

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