查询群组设备

更新时间：2023-11-23 06:25:42下载pdf

本文介绍查询群组设备的 API。

接口描述

根据群组 ID，查询群组下设备。

接口地址

GET: /v2.0/cloud/thing/group/{group_id}/devices

请求参数

参数名	类型	参数位置	是否必填	说明
group_id	Long	path	true	群组 ID。
page_size	Integer	query	true	每页数量。
page_no	Integer	query	true	当前页码。

返回参数

参数名	类型	说明
result	JSON	返回数据集合。
success	Boolean	操作是否成功。 `true`：操作成功。 `false`：操作失败。
t	Long	时间戳
tid	String	链路ID

result 说明

参数名	类型	说明
count	Integer	总数。
page_size	Integer	每页数量。
page_number	Integer	当前页码。
data_list	List	群组下设备数据列表。

data_list 说明

参数名	类型	说明
group_id	String	群组 ID。
dev_id	String	设备 ID。
status	Boolean	设备在群组中的状态。 `true`：有效。 `false`：无效。
display_order	Integer	设备排序。
gmt_create	Long	设备创建时间。
gmt_modified	Long	设备修改时间。

请求示例

GET: /v2.0/cloud/thing/group/12856***/devices

{
  "page_size": 1,
  "page_no": 1
}

返回示例

{
    "tid": "798a754bb31f11edaa2fba12a1143bd9",
    "result": {
        "data_list": [
            {
                "gmt_create": 1677118001658,
                "display_order": 1,
                "gmt_modified": 1677118001658,
                "dev_id": "vdevo163815529**",
                "group_id": "12856***",
                "status": true
            }
        ],
        "count": 1,
        "page_number": 1,
        "page_size": 1
    },
    "t": 1677118328341,
    "success": true
}

错误码

参考错误码。

调用频率限制

参考调用频率限制。

上一篇下发群组属性

下一篇场景联动规则