Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Réduction des coûts de messagerie avec Basic Ingest
Vous pouvez utiliser Basic Ingest pour envoyer en toute sécurité les données de l'appareil aux personnes Services AWS prises en charge parAWS IoT actions liées aux règles, sans frais de messagerie.
Basic Ingest peut envoyer des messages depuis vos appareils ou applications. Les messages ont des noms de rubrique qui commencent par $aws/rules/
les trois premiers niveaux, où rule_name
est le nom de la AWS IoT règle que vous souhaitez invoquer.rule_name
Vous pouvez utiliser une règle existante avec Basic Ingest en ajoutant simplement le préfixe Basic Ingest ($aws/rules/
) à la rubrique du message par lequel vous invoquez normalement la règle. Par exemple, si vous avez une règle nommée rule_name
BuildingManager
qui est invoquée par des messages avec des sujets tels que Buildings/Building5/Floor2/Room201/Lights
("sql": "SELECT * FROM
'Buildings/#'"
), vous pouvez invoquer la même règle avec Basic Ingest en envoyant un message avec le sujet $aws/rules/BuildingManager/Buildings/Building5/Floor2/Room201/Lights
.
Note
-
Vos appareils et vos règles ne peuvent pas s'abonner aux rubriques réservées Basic Ingest. Par exemple, les AWS IoT Device Defender
num-messages-received
métriques ne sont pas émises car elles ne permettent pas de s'abonner à des sujets. Pour de plus amples informations, veuillez consulter Rubriques réservées. -
Si vous avez besoin d'un courtier de publication/d'abonnement pour distribuer des messages à plusieurs abonnés (par exemple, pour envoyer des messages à d'autres appareils et au moteur de règles), vous devez continuer à utiliser le courtier de AWS IoT messages pour gérer la distribution des messages. Cependant, il suffit de publier vos messages dans des rubriques autres que les rubriques Basic Ingest.
Utilisation de Basic Ingest
Avant d'utiliser Basic Ingest, vérifiez que votre appareil ou application utilise une politique sur laquelle des autorisations de publication sont activées $aws/rules/*
. Vous pouvez également spécifier des autorisations pour des règles individuelles $aws/rules/
dans la politique. Sinon, vos appareils et applications peuvent continuer à utiliser leurs connexions existantes avec AWS IoT Core.rule_name
/*
Lorsque le message atteint le moteur de règles, il n'existe pas de différence dans l'exécution ou la gestion des erreurs entre les règles invoquées à partir de Basic Ingest et celles invoquées via des abonnements d'agent de messages.
Vous pouvez créer des règles à utiliser avec Basic Ingest. Gardez à l’esprit les points suivants :
-
Le préfixe initial d'une rubrique Basic Ingest (
$aws/rules/
) n'est pas disponible pour la fonction topic(Decimal).rule_name
-
Si vous définissez une règle qui est invoquée uniquement avec Basic Ingest, la clause
FROM
est facultative dans le champsql
de la définitionrule
. Elle est encore requise si la règle est également invoquée par d'autres messages qui doivent être envoyés via l'agent de messages (par exemple, parce que ces autres messages doivent être distribués à plusieurs abonnés). Pour de plus amples informations, veuillez consulter AWS IoT Référence SQL. -
Les trois premiers niveaux de la rubrique Basic Ingest (
$aws/rules/
) ne sont pas comptabilisés dans la limite de longueur des 8 segments ou des 256 caractères maximum pour une rubrique. Sinon, les mêmes restrictions que celles documentées dans AWS IoT Limites s'appliquent.rule_name
-
Si un message contenant une rubrique Basic Ingest spécifiant une règle inactive ou inexistante est reçu, un journal des erreurs est créé dans un CloudWatch journal Amazon pour vous aider à effectuer le débogage. Pour de plus amples informations, veuillez consulter Entrées de journal du moteur de règles. Une métrique
RuleNotFound
est indiquée et vous pouvez créer des alarmes sur cette métrique. Pour de plus amples informations, veuillez consulter Métriques dans Métriques de règle. -
Vous pouvez toujours publier avec QoS 1 dans des rubriques Basic Ingest. Vous recevez un message une PUBACK fois que le message a été envoyé avec succès au moteur de règles. Le fait de recevoir un PUBACK ne signifie pas que vos actions relatives aux règles ont été effectuées avec succès. Vous pouvez configurer une action d'erreur pour gérer les erreurs lors de l'exécution de l'action. Pour de plus amples informations, veuillez consulter Gestion des erreurs (action d'erreur).