获取设备群组列表

更新时间：2023-06-15 05:04:12

本文介绍获取设备群组列表的 API。

接口描述

分页获取设备群组列表信息。

接口地址

GET: /v1.0/iot-03/device-groups

请求参数

参数名	类型	参数位置	是否必填	说明
req	GroupPackageQueryReq	query	false	查询条件入参

req 说明

参数名	类型	是否必填	说明
group_name	String	false	群组名称
asset_id	String	false	资产 ID
asset_ids	String	false	资产 IDs
page_no	Integer	false	页码
page_size	Integer	false	页大小

返回参数

参数名	类型	说明
result	BasePageVO	返回分页结果

result 说明

参数名	类型	说明
has_more	Boolean	是否有下一页
total	Long	群组总数
list	List	群组列表

list 说明

参数名	类型	说明
group_id	String	群组 ID
group_name	String	群组名称
create_time	Long	创建时间
update_time	Long	更新时间
processing_status	Integer	群组任务处理状态。 0：群组设备添加/移除中 1：群组设备添加/移除全部成功 2：群组设备添加/移除部分成功 3：群组设备添加/移除全部失败
asset_id	String	资产 ID

请求示例

GET: /v1.0/iot-03/device-groups?pageNo=1&pageSize=2

返回示例

{
    "result": {
        "list": [
            {
                "create_time": 1623208592,
                "group_name": "test_group1111",
                "update_time": 1623324050,
                "group_id": "14024642592****"
            },
            {
                "create_time": 1623223232,
                "group_name": "group_test",
                "update_time": 1623223232,
                "group_id": "14025071296****"
            },
            {
                "create_time": 1623208448,
                "group_name": "group_test",
                "update_time": 1623208448,
                "group_id": "140246945728****"
            },
            {
                "create_time": 1623153892,
                "group_name": "group_test",
                "update_time": 1623153892,
                "group_id": "140223887040****"
            },
            {
                "create_time": 1623152145,
                "group_name": "group_test",
                "update_time": 1623152145,
                "group_id": "140228183552****"
            }
        ],
        "total": 14,
        "has_more": true
    },
    "t": 1623827448052,
    "success": true
}

错误码

参考错误码。