CreateConsumerGroup - IoT Platform - Centre de documentation Alibaba Cloud

Crée un groupe de consommateurs nécessaire à un abonnement côté serveur AMQP.

Limites

Chaque compte Alibaba Cloud peut effectuer au maximum 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. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer pour plus de commodité. L'outil génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CreateConsumerGroup	Opération à effectuer. Définissez la valeur sur CreateConsumerGroup.
GroupName	String	Oui	Consumer group 1	Nom du groupe de consommateurs. Il doit contenir entre 4 et 30 caractères, lettres, chiffres et traits de soulignement (_) uniquement.
IotInstanceId	String	Non	iot-cn-0pp1n8t****	ID de l'instance. Vous pouvez consulter l'Overview de l'instance dans la console IoT Platform. Important Si votre instance possède un ID, vous devez configurer ce paramètre, sans quoi l'appel échouera. Si votre instance ne possède ni page Overview ou ni ID, inutile de définir ce paramètre. Pour plus d'informations, consultez la rubrique Présentation.

Outre les paramètres spécifiques à l'opération, vous devez spécifier les paramètres de requête communs lors de l'appel. 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.
GroupId	String	nJRaJPn5U1JITGf******	ID du groupe de consommateurs.
RequestId	String	73B9DF43-7780-47DE-8BED-077729D28BD2	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : appel réussi. false : échec de l'appel.

Exemples

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=CreateConsumerGroup
&GroupName=Consumer group 1
&<Common request parameters>

Exemple de réponse réussie

Format XML

<CreateConsumerGroupResponse>
    <GroupId>nJRaJPn5U1JITGf******</GroupId>
    <RequestId>73B9DF43-7780-47DE-8BED-077729D28BD2</RequestId>
    <Success>true</Success>
</CreateConsumerGroupResponse>

Format JSON

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

Codes d'erreur

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