调用该接口查询分组详情。

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作。取值:QueryDeviceGroupInfo
GroupId String 分组ID,分组的全局唯一标识符。
IotInstanceId String 公共实例不传此参数;仅独享实例需传入实例ID。
公共请求参数 - 请参见公共参数

返回参数

名称 类型 描述
RequestId String 阿里云为该请求生成的唯一标识符。
Success Boolean 表示是否调用成功。true表示调用成功,false表示调用失败。
ErrorMessage String 调用失败时,返回的出错信息。
Code String 返回错误码,请参见错误码
Data Data 调用成功时,返回的分组详细信息数据。请参考下表GroupInfo。
表 1. GroupInfo
名称 类型 描述
GroupName String 分组名称。
UtcCreate String 创建时间。
DeviceOnline Integer 在线设备数量。
DeviceActive Integer 激活设备数量。
DeviceCount Integer 设备总数。
GroupId String 分组ID。
GroupDesc String 分组描述。

示例

请求示例

http://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceGroupInfo
&GroupId=tDQvBJqbUyHs****
&公共请求参数

返回示例

  • JSON格式
    {
        "Data":{
            "DeviceOnline":0,
            "DeviceActive":1,
            "GroupName":"yanglv",
            "DeviceCount":10,
            "UtcCreate":"2018-09-14T14:35:51.000Z",
            "GroupId":"tDQvBJqbUyHskDse"
        },
        "RequestId":"7411716B-A488-4EEB-9AA0-6DB05AD2491F",
        "Success":true
    }
  • XML格式
    <?xml version="1.0" encoding="UTF-8" ?>
    <QueryDeviceGroupInfoResponse>
        <Data>
            <DeviceOnline>0</DeviceOnline>
            <DeviceActive>1</DeviceActive>
            <GroupName>yanglv</GroupName>
            <DeviceCount>10</DeviceCount>
            <UtcCreate>2018-09-14T14:35:51.000Z</UtcCreate>
            <GroupId>tDQvBJqbUyHskDse</GroupId>
        </Data>
        <RequestId>7411716B-A488-4EEB-9AA0-6DB05AD2491F</RequestId>
        <Success>true</Success>
    </QueryDeviceGroupInfoResponse>