IoT Platform:Configurer un abonnement côté serveur AMQP

Prérequis

Vous avez créé un groupe de consommateurs. Ce groupe sert à s'abonner aux messages des topics. Vous pouvez utiliser le groupe de consommateurs par défaut (DEFAULT_GROUP) ou créer un groupe de consommateurs dans IoT Platform. Pour plus d'informations, consultez Gérer les groupes de consommateurs.

Configurer un abonnement

Pour spécifier le type de messages auxquels vous souhaitez vous abonner, suivez ces étapes :

1. Connectez-vous à la console IoT Platform.

2. Sur la page Overview, localisez l'instance à gérer et cliquez sur son ID ou son nom.

3. Dans le volet de navigation de gauche, choisissez Message Forwarding > Server-side Subscription.

4. Sur la page Server-side Subscription, cliquez sur Create Subscription.

5. Dans la boîte de dialogue Create Subscription, configurez les paramètres et cliquez sur OK. Le tableau suivant décrit ces paramètres.

   Parameter	Description
   Products	Sélectionnez le produit auquel appartiennent les appareils. Les messages envoyés par les appareils sont transmis aux consommateurs.
   Subscription Type	Sélectionnez AMQP.
   Consumer Group	Sélectionnez les groupes de consommateurs. Vous pouvez spécifier plusieurs groupes de consommateurs pour un produit et créer plusieurs abonnements pour plusieurs produits au sein d'un même groupe de consommateurs. IoT Platform fournit un groupe de consommateurs par défaut pour consommer les messages. Si vous souhaitez regrouper les consommateurs, créez un groupe de consommateurs en suivant ces étapes : dans le coin inférieur droit de la boîte de dialogue Select Consumer Groups, cliquez sur Create Consumer Group et configurez les paramètres selon les instructions. Pour plus d'informations, consultez Gérer les groupes de consommateurs.
   Message Type	Sélectionnez les types de messages. Vous pouvez vous abonner aux types de messages d'appareil suivants. Pour plus d'informations sur les topics de communication de base, les topics de transfert de messages et les formats de données associés, consultez Formats de données. Important Si vous utilisez des produits et des appareils de passerelle cloud, IoT Platform ne transmet aux produits et aux appareils que les messages Device Upstream Notification, Device Status Change Notification et Device Changes Throughout Lifecycle. Pour plus d'informations sur les topics de transfert de messages et les formats de données, consultez Messagerie via MQTT open source, Messagerie via JT/T 808 et Messagerie via GB/T 32960. Device Upstream Notification : les messages des topics dont le paramètre Allowed Operations est défini sur Publish. Pour plus d'informations, consultez Qu'est-ce qu'un topic. Les messages incluent des données personnalisées et des données Thing Specification Language (TSL) soumises par les appareils. Les données TSL ascendantes comprennent les données de propriété, les données d'événement, les réponses aux demandes de définition de propriétés et les réponses aux appels de service. IoT Platform traite les données TSL transmises aux serveurs utilisateurs. Pour plus d'informations, consultez Formats de données. Par exemple, les catégories de topics suivantes sont définies pour un produit : /${YourProductKey}/${YourDeviceName}/user/get. Le paramètre Allowed Operations de cette catégorie de topic est défini sur Subscribe. /${YourProductKey}/${YourDeviceName}/user/update. Le paramètre Allowed Operations de cette catégorie de topic est défini sur Publish. /${YourProductKey}/${YourDeviceName}/thing/event/property/post. Le paramètre Allowed Operations de cette catégorie de topic est défini sur Publish. La fonctionnalité d'abonnement côté serveur transmet les messages des catégories de topics suivantes : /${YourProductKey}/${YourDeviceName}/user/update et /${YourProductKey}/${YourDeviceName}/thing/event/property/post. Important Si vous souhaitez vous abonner aux données de réponse des appels de service asynchrones, assurez-vous que l'ID de message renvoyé par l'appareil est identique à l'ID de message généré lorsque IoT Platform envoie des données descendantes. Device Status Change Notification : les notifications envoyées par les appareils lors de leur connexion ou déconnexion. Gateway's sub-devices discovery report : les données de sous-appareils soumises par les passerelles lorsqu'elles détectent de nouveaux sous-appareils. Les passerelles doivent disposer d'applications permettant de détecter les sous-appareils. Ce type de message est spécifique aux passerelles. Device Topological Relation Changes : les notifications envoyées par les passerelles lors de la création ou de la suppression de relations topologiques entre les sous-appareils et les passerelles. Ce type de message est spécifique aux passerelles. Device Changes Throughout Lifecycle : les notifications envoyées par les appareils lors de leur création, suppression, activation ou désactivation. TSL Historical Data Reporting : les propriétés et événements historiques soumis par les appareils. OTA Update Status Notification : les notifications envoyées par les appareils pendant la vérification du firmware et la mise à jour par lots. Une notification est transmise lorsqu'une tâche de mise à jour d'appareil réussit, échoue, est annulée ou est en cours d'exécution. Device tag change : les messages envoyés par les appareils lors de la modification des tags d'appareil. Submit a module version number : les messages envoyés par les appareils lors de la modification des versions de module OTA (over-the-air). Batch status notification : les notifications envoyées par les appareils lors de la modification du statut des lots de mise à jour OTA. Remarque Lorsque vous écoutez les messages des appareils, il peut être nécessaire de les filtrer ou de les traiter. Dans ce cas, transférez les messages vers un groupe de consommateurs AMQP à l'aide de règles de transfert de données. Vous pouvez ensuite recevoir les messages via le client AMQP. Pour plus d'informations, consultez Transfert de données. Pour plus d'informations sur la manière de transférer des messages vers un serveur AMQP et sur les topics d'appareil auxquels vous pouvez vous abonner, consultez Formats de données.

Gérer les abonnements d'un produit

Après avoir configuré un abonnement, accédez à la page Server-side Subscription et localisez le produit pour lequel l'abonnement a été créé. Plusieurs opérations sont disponibles pour cet abonnement. Le tableau suivant les décrit.

Étapes suivantes

Configurer un client AMQP : Nous vous recommandons d'utiliser le SDK AMQP fourni par IoT Platform. Alibaba Cloud n'assure pas de support technique pour les SDK AMQP développés par les utilisateurs.