Todos los productos
Search
Centro de documentos

IoT Platform:CreateConsumerGroupSubscribeRelation

Última actualización: Sep 03, 2026

Agrega un grupo de consumidores a una suscripción AMQP.

Límites

Cada cuenta de Alibaba Cloud admite un máximo de 5 consultas por segundo (QPS).

Nota

Los usuarios RAM de una cuenta de Alibaba Cloud comparten la cuota de dicha cuenta.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

ParámetroTipoObligatorioEjemploDescripción
ActionStringSíCreateConsumerGroupSubscribeRelation

La operación que desea ejecutar. Establezca el valor en CreateConsumerGroupSubscribeRelation.

ConsumerGroupIdStringSínJRaJPn5U1JITGfjBO9l00****

El ID del grupo de consumidores. Tras llamar a la operación CreateConsumerGroup para crear un grupo de consumidores, se devuelve el ID del grupo. Puede llamar a la operación QueryConsumerGroupList para consultar el ID del grupo de consumidores por nombre. También puede ir a la consola de IoT Platform,y elegir Rules > Server-side Subscription > Consumer Groups para consultar el ID del grupo de consumidores.

ProductKeyStringSía1fyXVF****

La clave ProductKey del producto especificado para la suscripción.

IotInstanceIdStringNoiot-cn-0pp1n8t****

El ID de la instancia. Puede consultar el ID de la instancia en la página Overview de la consola de IoT Platform.

Importante
  • Si su instancia tiene un ID, debe configurar este parámetro. De lo contrario, la llamada fallará.
  • Si su instancia no tiene página de Overview o ID, no es necesario establecer este parámetro.

Para obtener más información, consulte Descripción general.

Además de los parámetros específicos de la operación anteriores, debe especificar los parámetros de solicitud comunes al llamar a esta operación. Para obtener más información, consulte Parámetros de solicitud comunes.

Parámetros de respuesta

ParámetroTipoEjemploDescripción
CodeStringiot.system.SystemException

El código de error devuelto si la llamada falla. Para obtener más información, consulte Códigos de error.

ErrorMessageStringA system exception occurred.

El mensaje de error devuelto si la llamada falla.

RequestIdStringE55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

El ID de la solicitud.

SuccessBooleantrue

Indica si la llamada se realizó correctamente.

  • true: La llamada se realizó correctamente.
  • false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=CreateConsumerGroupSubscribeRelation
&ProductKey=a1Zkii7****
&ConsumerGroupId=nJRaJPn5U1JITGfjBO9l00****
&<Common request parameters>

Respuestas correctas de ejemplo

Formato XML

<CreateConsumerGroupSubscribeRelationResponse>
       <RequestId>73B9DF43-7780-47DE-8BED-077729D28BD2</RequestId>
       <Success>true</Success>
</CreateConsumerGroupSubscribeRelationResponse>

Formato JSON

{
  "RequestId": "73B9DF43-7780-47DE-8BED-077729D28BD2",
  "Success": true
}

Códigos de error

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