ResetConsumerGroupPosition - IoT Platform - Centre de documentation Alibaba Cloud

Supprime les messages accumulés d'un groupe de consommateurs lors de l'utilisation d'un abonnement côté serveur AMQP.

Limites

Chaque compte Alibaba Cloud peut exécuter un maximum de 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 la requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ResetConsumerGroupPosition	Opération à effectuer. Définissez la valeur sur ResetConsumerGroupPosition.
GroupId	String	Oui	nJRaJPn5U1JITGf******	ID du groupe de consommateurs. Après avoir appelé l'opération CreateConsumerGroup pour créer un groupe de consommateurs, l'ID du groupe de consommateurs est renvoyé. Vous pouvez appeler l'opération QueryConsumerGroupList pour interroger l'ID du groupe de consommateurs par nom de groupe. Vous pouvez également accéder à la console IoT Platform,, puis choisissez Rules > Server-side Subscription > Consumer Groups pour afficher l'ID du groupe de consommateurs.
IotInstanceId	String	Non	iot-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 configurer ce paramètre. Si vous ne définissez pas ce paramètre, l'appel échoue. Si votre instance ne dispose pas de Overview page ou d'ID, vous n'avez pas besoin de définir ce paramètre. Pour en savoir plus, consultez la rubrique Overview.

En plus des paramètres de requête spécifiques à l'opération mentionnés ci-dessus, vous devez spécifier les paramètres de requête communs lorsque vous appelez cette opération. Pour plus d'informations, consultez la rubrique Paramètres de requête communs.

Paramètres de réponse

Paramètre	Type	Exemple	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	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	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=ResetConsumerGroupPosition
&GroupId=nJRaJPn5U1JITGf******
&<Common request parameters>

Exemple de réponse réussie

XML format

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

JSON format

{
  "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.