Todos los productos
Search
Centro de documentos

IoT Platform:QuerySuperDeviceGroup

Última actualización: Sep 03, 2026

Consulta la información del grupo principal mediante el ID del subgrupo.

Límites

Máximo 10 QPS por cuenta de Alibaba Cloud.

Nota

Los usuarios de RAM comparten la cuota de la cuenta.

Depuración

Ejecute esta operación en OpenAPI Explorer, que calcula automáticamente la firma y genera código de ejemplo del SDK.

Parámetros de solicitud

Parámetro Tipo Obligatorio Ejemplo Descripción
Action String Sí QuerySuperDeviceGroup

Operación a ejecutar. Establezca el valor en QuerySuperDeviceGroup.

GroupId String Sí DMoI2Kby5m62****

ID del subgrupo, que corresponde al identificador único global (GUID) del grupo.

IotInstanceId String No iot_instc_pu****_c*-v64********

ID de la instancia. Consúltelo en la página Descripción general de la consola de IoT Platform.

Importante
  • Obligatorio si su instancia tiene un ID. La llamada falla sin este valor.
  • No es obligatorio si su instancia no tiene página Descripción general ni ID.

Descripción general.

Esta operación también requiere los parámetros de solicitud comunes.

Parámetros de respuesta

Parámetro Tipo Ejemplo Descripción
Code String iot.system.SystemException

Código de error devuelto en caso de fallo. Códigos de error.

Data Array of GroupInfo

Información del grupo principal devuelta en caso de éxito. Consulte el parámetro GroupInfo a continuación.

GroupInfo
GroupDesc String A test

Descripción del grupo principal.

GroupId String tDQvBJqbUyHskDse

ID del grupo principal.

GroupName String IOTTEST

Nombre del grupo principal.

ErrorMessage String A system exception occurred.

Mensaje de error devuelto en caso de fallo.

RequestId String 7411716B-A488-4EEB-9AA0-6DB05AD2491F

ID de la solicitud.

Success Boolean true

Indica si la llamada se realizó correctamente.

  • true: La llamada fue exitosa.
  • false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=QuerySuperDeviceGroup
&GroupId=DMoI2Kby5m62****
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<QuerySuperDeviceGroupResponse>
      <Data>
            <GroupName>IOTTEST</GroupName>
            <GroupId>tDQvBJqbUyHskDse</GroupId>
            <GroupDesc>A test.</GroupDesc>
      </Data>
      <RequestId>7411716B-A488-4EEB-9AA0-6DB05AD2491F</RequestId>
      <Success>true</Success>
</QuerySuperDeviceGroupResponse>

Formato JSON

{
    "Data":{
        "GroupName":"IOTTEST",
        "GroupId":"tDQvBJqbUyHskDse",
    "GroupDesc":"A test."
    },
    "RequestId":"7411716B-A488-4EEB-9AA0-6DB05AD2491F",
    "Success":true
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.