UpdateConsumerGroup - IoT Platform - Centre de documentation Alibaba Cloud

Modifie un groupe de consommateurs lors de la configuration d'un abonnement côté serveur AMQP.

Limites

Il est impossible de modifier le groupe de consommateurs par défaut fourni par IoT Platform.
Chaque compte Alibaba Cloud est limité à 5 requêtes par seconde (QPS).

Remarque
Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota de ce compte.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	UpdateConsumerGroup	Opération à exécuter. Définissez la valeur sur UpdateConsumerGroup.
GroupId	String	Yes	nJRaJPn5U1JITGf******	ID du groupe de consommateurs. L'ID est renvoyé après l'appel de l'opération CreateConsumerGroup qui crée le groupe. Appelez l'opération QueryConsumerGroupList pour récupérer l'ID via le nom du groupe. Vous pouvez également accéder à la console IoT Platform,puis choisir Rules > Server-side Subscription > Consumer Groups pour afficher l'ID du groupe de consommateurs.
NewGroupName	String	Yes	Consumer group 2	Nouveau nom du groupe de consommateurs. Le nom doit comporter entre 4 et 30 caractères et peut contenir des lettres, des chiffres et des traits de soulignement (_).
IotInstanceId	String	No	iot-cn-0pp1n8t****	ID de l'instance. Consultez l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez configurer ce paramètre. À défaut, l'appel échoue. Si votre instance ne possède pas de page Overview ou d'ID, ce paramètre est facultatif. Pour plus d'informations, consultez la rubrique Overview.

Outre les paramètres de requête spécifiques à l'opération 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 la rubrique Paramètres de requête communs.

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez la rubrique Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	73B9DF43-7780-47DE-8BED-077729D28BD2	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=UpdateConsumerGroup
&GroupId=nJRaJPn5U1JITGf******
&GroupName=Consumer group 2
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

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 de l'API.