调用该接口分页查询分组列表。

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作。取值:QueryDeviceGroupList
GroupName String 分组名称。
  • 传入分组名称,则根据名称进行查询。支持分组名称模糊查询。
  • 若不传入此参数,则进行全量分组查询。
SuperGroupId String 父组ID。查询某父组下的子分组列表时,需传入此参数。
PageSize Integer 每页记录数。最大值是200。默认值是10。
CurrentPage Integer 指定从返回结果中的第几页开始显示。默认值为1。
IotInstanceId String 公共实例不传此参数;仅独享实例需传入实例ID。
公共请求参数 - 请参见公共参数

返回参数

名称 类型 描述
RequestId String 阿里云为该请求生成的唯一标识符。
Success Boolean 表示是否调用成功。true表示调用成功,false表示调用失败。
ErrorMessage String 调用失败时,返回的出错信息。
Code String 返回错误码,请参见错误码
PageCount Integer 总页数。
PageSize Integer 每页记录数。
CurrentPage Integer 当前页号。
Total Integer 总记录数。
Data Data 调用成功时,返回的分组信息。请参见下表GroupInfo。
说明 返回的分组信息按照分组创建时间倒序排列。
表 1. GroupInfo
名称 类型 描述
GroupName String 分组名称。
UtcCreate Date 分组创建时间。
GroupDesc String 分组描述。
GroupId String 分组ID。

示例

请求示例

http://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceGroupList
&PageSize=10
&CurrentPage=1
&公共请求参数

返回示例

  • JSON格式
    {
        "PageCount":3,
        "Data":{
            "GroupInfo":[
                {
                    "GroupName":"test1",
                    "UtcCreate":"2018-10-09T02:58:34.000Z",
                    "GroupId":"Kzt9FD8wje8o****"
                },
                {
                    "GroupName":"test2",
                    "UtcCreate":"2018-10-09T02:56:40.000Z",
                    "GroupId":"0ayrSQ3DSd7uXXXC"
                },
                {
                    "GroupDesc":"Test",
                    "GroupName":"test3",
                    "UtcCreate":"2018-09-16T05:38:27.000Z",
                    "GroupId":"oWXlIQeFZtzC****"
                },
                {
                    "GroupName":"ylv0915",
                    "UtcCreate":"2018-09-15T04:51:56.000Z",
                    "GroupId":"SfEiVapLPUjB****"
                },
                {
                    "GroupName":"ydlv",
                    "UtcCreate":"2018-09-14T14:35:51.000Z",
                    "GroupId":"z2S2h9NsDTZm****"
                },
                {
                    "GroupName":"ldh_group_3",
                    "UtcCreate":"2018-09-14T12:26:20.000Z",
                    "GroupId":"chn5fkjinXGc7pGl"
                },
                {
                    "GroupDesc":"ddd",
                    "GroupName":"ylvgisbim",
                    "UtcCreate":"2018-09-14T11:41:20.000Z",
                    "GroupId":"ncUZ8DjWYaB9****"
                },
                {
                    "GroupName":"abc",
                    "UtcCreate":"2018-09-14T09:14:30.000Z",
                    "GroupId":"zpdvwxzBdt4F****"
                },
                {
                    "GroupName":"test11",
                    "UtcCreate":"2018-09-14T07:22:39.000Z",
                    "GroupId":"BTaudF16X2xK****"
                },
                {
                    "GroupName":"testy",
                    "UtcCreate":"2018-09-14T01:58:06.000Z",
                    "GroupId":"PrTm3VOeggPw****"
                }
            ]
        },
        "PageSize":10,
        "RequestId":"BEFCA316-D6C7-470C-81ED-1FF4FFD4AA0D",
        "CurrentPage":1,
        "Success":true,
        "Total":24
    }
  • XML格式
    <?xml version="1.0" encoding="UTF-8" ?>
    <QueryDeviceGroupListResponse>
        <PageCount>3</PageCount>
        <Data>
            <GroupInfo>
                <GroupName>test1</GroupName>
                <UtcCreate>2018-10-09T02:58:34.000Z</UtcCreate>
                <GroupId>Kzt9FD8wje8o****</GroupId>
            </GroupInfo>
            <GroupInfo>
                <GroupName>test2</GroupName>
                <UtcCreate>2018-10-09T02:56:40.000Z</UtcCreate>
                <GroupId>0ayrSQ3DSd7u****</GroupId>
            </GroupInfo>
            <GroupInfo>
                <GroupDesc>Test</GroupDesc>
                <GroupName>test3</GroupName>
                <UtcCreate>2018-09-16T05:38:27.000Z</UtcCreate>
                <GroupId>oWXlIQeFZtzC****</GroupId>
            </GroupInfo>
            <GroupInfo>
                <GroupName>ylv0915</GroupName>
                <UtcCreate>2018-09-15T04:51:56.000Z</UtcCreate>
                <GroupId>SfEiVapLPUjBVvSq</GroupId>
            </GroupInfo>
            <GroupInfo>
                <GroupName>ydlv</GroupName>
                <UtcCreate>2018-09-14T14:35:51.000Z</UtcCreate>
                <GroupId>z2S2h9NsDTZm****</GroupId>
            </GroupInfo>
            <GroupInfo>
                <GroupName>ldh_group_3</GroupName>
                <UtcCreate>2018-09-14T12:26:20.000Z</UtcCreate>
                <GroupId>chn5fkjinXGc****</GroupId>
            </GroupInfo>
            <GroupInfo>
                <GroupDesc>ddd</GroupDesc>
                <GroupName>ylvgisbim</GroupName>
                <UtcCreate>2018-09-14T11:41:20.000Z</UtcCreate>
                <GroupId>ncUZ8DjWYaB9****</GroupId>
            </GroupInfo>
            <GroupInfo>
                <GroupName>abc</GroupName>
                <UtcCreate>2018-09-14T09:14:30.000Z</UtcCreate>
                <GroupId>zpdvwxzBdt4F****</GroupId>
            </GroupInfo>
            <GroupInfo>
                <GroupName>test11</GroupName>
                <UtcCreate>2018-09-14T07:22:39.000Z</UtcCreate>
                <GroupId>BTaudF16X2xK****</GroupId>
            </GroupInfo>
            <GroupInfo>
                <GroupName>testy</GroupName>
                <UtcCreate>2018-09-14T01:58:06.000Z</UtcCreate>
                <GroupId>PrTm3VOeggPw****</GroupId>
            </GroupInfo>
        </Data>
        <PageSize>10</PageSize>
        <RequestId>BEFCA316-D6C7-470C-81ED-1FF4FFD4AA0D</RequestId>
        <CurrentPage>1</CurrentPage>
        <Success>true</Success>
        <Total>24</Total>
    </QueryDeviceGroupListResponse>