Query Group Devices

Last Updated on : 2024-06-29 02:35:00download

Query devices in the specified group based on the group ID.

API address

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

Request parameter

Parameter name	Type	IN	Required	Description
group_id	Long	path	true	The group ID.
page_no	Integer	query	true	The current page number.
page_size	Integer	query	true	The number of entries to be returned per page.

Return parameter

Parameter name	Type	Description
result	JsonObject	The returned result of the specified group.
success	Boolean	Indicates whether the API is called successfully. Valid values: `true`: The API call succeeded. `false`: The API call failed.
t	Long	The timestamp.
tid	String	The link ID.

Description of result

Parameter name	Type	Description
data_list	List	The list of data.
count	Integer	The total number of returned entries.
page_size	Integer	The number of entries to be returned per page.
page_no	Integer	The current page number.

Description of data_list

Parameter name	Type	Description
group_id	Long	The group ID.
device_id	String	The device ID.
create_time	Long	The time when the relationship between the group and the device is established.
update_time	Long	The time when the relationship between the group and the device is updated.

Request example

GET: /v2.1/cloud/thing/group/1393****/devices?page_no=1&page_size=10

Return example

{
    "tid": "e4d2d4b1022111efbe7a366d87620758",
    "result": {
        "data_list": [
            {
                "create_time": 1713944885103,
                "device_id": "vdevo17059963185****",
                "update_time": 1713944885103,
                "group_id": "1393****"
            },
            {
                "create_time": 1713949980073,
                "device_id": "vdevo17059988536****",
                "update_time": 1713949980073,
                "group_id": "1393****"
            },
            {
                "create_time": 1713944885355,
                "device_id": "vdevo17059963113****",
                "update_time": 1713944885355,
                "group_id": "1393****"
            }
        ],
        "count": 3,
        "page_no": 1,
        "page_size": 10
    },
    "t": 1713953006944,
    "success": true
}

Error code

For more information, see error code.

Limits on API Request Frequency

For more information, see Limits on API Request Frequency.

Prev DocDelete Group

Next DocModify Group Information