Utilisation des destinations des règles de rubrique HTTP

Une destination de règle de sujet HTTP est un service Web vers lequel le moteur de règles peut acheminer les données d'une règle de sujet. Une AWS IoT Core ressource décrit le service Web pour AWS IoT. Les ressources de destination des règles thématiques peuvent être partagées selon différentes règles.

Avant de AWS IoT Core pouvoir envoyer des données à un autre service Web, celui-ci doit confirmer qu'il peut accéder au point de terminaison du service.

Vue d'ensemble des destinations de règle de rubrique HTTP

Une destination de règle de rubrique HTTP fait référence à un service Web qui prend en charge une URL de confirmation et une ou plusieurs URL de collecte de données. La ressource de destination des règles de rubrique HTTP contient l'URL de confirmation de votre service Web. Lorsque vous configurez une action de règle de rubrique HTTP, vous spécifiez l'URL réelle du point de terminaison qui doit recevoir les données ainsi que l'URL de confirmation du service Web. Une fois votre destination confirmée, la règle du sujet envoie le résultat de l'instruction SQL au point de terminaison HTTPS (et non à l'URL de confirmation).

La destination d'une règle de thème HTTP peut se trouver dans l'un des états suivants :

ENABLED

La destination a été confirmée et peut être utilisée par une action de règle. L'état d'une destination doit être ENABLED (ACTIVÉ) pour qu'elle soit utilisée dans une règle. Vous pouvez uniquement activer une destination dont l'état est DISABLED (DÉSACTIVÉ).

DISABLED

La destination a été confirmée mais elle ne peut pas être utilisée par une action de règle. Cet état est utile si vous souhaitez empêcher temporairement le trafic vers votre point de terminaison sans avoir à passer à nouveau par le processus de confirmation. Vous pouvez uniquement désactiver une destination dont l'état est ENABLED (ACTIVÉ).

EN_COURS

La confirmation de la destination est en cours.

ERROR

La confirmation de la destination a expiré.

Une fois que la destination d'une règle de thème HTTP a été confirmée et activée, elle peut être utilisée avec n'importe quelle règle de votre compte.

Les sections suivantes décrivent les actions les plus courantes sur les destinations des règles de rubrique HTTP.

Création de destinations de règles de rubrique HTTP

Vous créez une destination de règle de sujet HTTP en appelant l'CreateTopicRuleDestinationopération ou en utilisant la AWS IoT console.

Après avoir créé une destination, AWS IoT envoie une demande de confirmation à l'URL de confirmation. Le format de la demande de confirmation est le suivant :

HTTP POST {confirmationUrl}/?confirmationToken={confirmationToken}
Headers:
x-amz-rules-engine-message-type: DestinationConfirmation
x-amz-rules-engine-destination-arn:"arn:aws:iot:us-east-1:123456789012:ruledestination/http/7a280e37-b9c6-47a2-a751-0703693f46e4"
Content-Type: application/json
Body:
{
    "arn":"arn:aws:iot:us-east-1:123456789012:ruledestination/http/7a280e37-b9c6-47a2-a751-0703693f46e4",  
    "confirmationToken": "AYADeMXLrPrNY2wqJAKsFNn-…NBJndA",
    "enableUrl": "https://iot.us-east-1.amazonaws.com/confirmdestination/AYADeMXLrPrNY2wqJAKsFNn-…NBJndA",
    "messageType": "DestinationConfirmation"
}

Le contenu de la demande de confirmation comprend les informations suivantes :

arn

L'Amazon Resource Name (ARN) de la destination de la règle de rubrique à confirmer.

confirmationToken

Le jeton de confirmation envoyé par AWS IoT Core. Dans l'exemple, le jeton est tronqué. Votre jeton sera plus long. Vous aurez besoin de ce jeton pour confirmer votre destination AWS IoT Core.

enableUrl

L'URL à laquelle vous accédez pour confirmer la destination d'une règle de rubrique.

messageType

Type du message.

Confirmation des destinations des règles de rubrique HTTP

Pour terminer le processus de confirmation du point de terminaison, si vous utilisez le AWS CLI, vous devez effectuer les étapes suivantes une fois que votre URL de confirmation a reçu la demande de confirmation.

1. Confirmez que la destination accepte de recevoir des messages

   Pour confirmer que la destination de la règle thématique est prête à recevoir des messages IoT, appelez le enableUrl dans la demande de confirmation ou effectuez l'opération ConfirmTopicRuleDestination API et transmettez le contenu confirmationToken de la demande de confirmation.

2. Définir le statut des règles du sujet sur Activé

   Après avoir confirmé que la destination peut recevoir des messages, vous devez exécuter l'opération d'UpdateTopicRuleDestinationAPI pour définir le statut de la règle du sujet surENABLED.

Si vous utilisez la AWS IoT console, copiez-la confirmationToken et collez-la dans la boîte de dialogue de confirmation de la destination dans la AWS IoT console. Vous pouvez ensuite activer la règle du sujet.

Envoi d'une nouvelle demande de confirmation

Pour activer un nouveau message de confirmation pour une destination, appelez UpdateTopicRuleDestination et réglez le statut de la règle de thème destination sur IN_PROGRESS.

Répétez le processus de confirmation après avoir envoyé une nouvelle demande de confirmation.

Désactivation et suppression de la destination d'une règle thématique

Pour désactiver une destination, appelez UpdateTopicRuleDestination et définissez l'état de la destination de règle de rubrique sur DISABLED. Une règle de rubrique à l'état DÉSACTIVÉ peut être réactivée sans qu'il soit nécessaire d'envoyer une nouvelle demande de confirmation.

Pour supprimer une destination de règle de rubrique, appelez DeleteTopicRuleDestination.