QueryConsumerGroupByGroupId - IoT Platform - Centro de documentación de Alibaba Cloud

Consulta los detalles de un grupo de consumidores mediante su ID de grupo para suscripciones del lado del servidor AMQP.

Límites

Cada cuenta de Alibaba Cloud admite un máximo de 5 QPS.

Nota

Los usuarios de RAM comparten la cuota de la cuenta.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Ejecute esta operación en OpenAPI Explorer para generar código de ejemplo para distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	QueryConsumerGroupByGroupId	Operación a ejecutar. Establezca el valor en QueryConsumerGroupByGroupId.
GroupId	String	Sí	nJRaJPn5U1JITGf******	ID del grupo de consumidores que devuelve la operación CreateConsumerGroup. También puede llamar a QueryConsumerGroupList para consultar por nombre de grupo, o buscarlo en la consola de IoT Platform en Rules > Server-side Subscription > Consumer Groups.
IotInstanceId	String	No	iot-cn-0pp1n8t****	ID de la instancia, disponible en la página Overview de la consola de IoT Platform. Importante Obligatorio si su instancia tiene un ID. Sin este valor, la llamada falla. No es obligatorio si su instancia no tiene página Overview 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 en caso de fallo. Códigos de error.
Data	Struct		Detalles del grupo de consumidores. Se devuelven en caso de éxito.
CreateTime	String	2020-05-20T00:05:20.000Z	Hora de creación del grupo de consumidores, en formato UTC. Formato: yyyy-MM-ddTHH:mm:ss.SSSZ (ISO 8601).
GroupId	String	nJRaJPn5U1JITGf******	ID del grupo de consumidores.
GroupName	String	Consumer group 1	Nombre del grupo de consumidores.
ErrorMessage	String	A system exception occurred.	Mensaje de error en caso de fallo.
RequestId	String	73B9DF43-7780-47DE-8BED-077729D28BD2	ID de la solicitud.
Success	Boolean	true	Indica si la llamada se ejecutó correctamente. true: La llamada fue exitosa. false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato XML

<QueryConsumerGroupByGroupIdResponse>
    <Data>
        <GroupId>nJRaJPn5U1JITGf******</GroupId>
        <GroupName>Consumer group 1</GroupName>
        <CreateTime>2019-11-12T11:19:13.000Z</CreateTime>
    </Data>
    <RequestId>73B9DF43-7780-47DE-8BED-077729D28BD2</RequestId>
    <Success>true</Success>
</QueryConsumerGroupByGroupIdResponse>

Formato JSON

{
  "Data": {
        "GroupId": "nJRaJPn5U1JITGf******",
        "GroupName": "Consumer Group 1",
        "CreateTime": "2019-11-12T11:19:13.000Z"
    },
  "RequestId": "73B9DF43-7780-47DE-8BED-077729D28BD2",
  "Success": true
}

Códigos de error

Visite el Centro de errores de API para consultar más códigos de error.