Tous les produits
Search
Centre de documentation

IoT Platform:CreateConsumerGroupSubscribeRelation

Dernière mise à jour :Aug 09, 2026

Ajoute un groupe de consommateurs à un abonnement AMQP.

Limites

Chaque compte Alibaba Cloud peut exécuter au maximum 5 requêtes par seconde (QPS).

Remarque

Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota du compte.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

ParamètreTypeObligatoireExempleDescription
ActionStringOuiCreateConsumerGroupSubscribeRelation

Opération à effectuer. Définissez la valeur sur CreateConsumerGroupSubscribeRelation.

ConsumerGroupIdStringOuinJRaJPn5U1JITGfjBO9l00****

ID du groupe de consommateurs. L'appel de l'opération CreateConsumerGroup permet de créer un groupe de consommateurs et renvoie son ID. Vous pouvez également appeler l'opération QueryConsumerGroupList pour récupérer l'ID du groupe de consommateurs à partir de son nom. Sinon, accédez à la console IoT Platform,sélectionnez Rules > Server-side Subscription > Consumer Groups pour afficher l'ID du groupe de consommateurs.

ProductKeyStringOuia1fyXVF****

Clé ProductKey du produit spécifié pour l'abonnement.

IotInstanceIdStringNoniot-cn-0pp1n8t****

ID de l'instance. Vous pouvez consulter l'ID de l'instance sur la page Overview de la console IoT Platform.

Important
  • Si votre instance possède un ID, vous devez définir ce paramètre. À défaut, l'appel échouera.
  • Si votre instance ne dispose pas de page Overview ni d'ID, il n'est pas nécessaire de définir ce paramètre.

Pour plus d'informations, consultez Overview.

Outre les paramètres de requête spécifiques à l'opération mentionnés ci-dessus, vous devez spécifier des paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations, consultez Common request parameters.

Paramètres de réponse

ParamètreTypeExempleDescription
CodeStringiot.system.SystemException

Code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez Error codes.

ErrorMessageStringA system exception occurred.

Message d'erreur renvoyé en cas d'échec de l'appel.

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

ID de la requête.

SuccessBooleantrue

Indique si l'appel a réussi.

  • true : L'appel a réussi.
  • false : L'appel a échoué.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

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

Format JSON

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.