Gestion des destinations des règles HTTP thématiques - AWS IoT Core
Création de destinations de règles HTTP thématiquesConfirmation des destinations des règles de HTTP sujetEnvoi d'une nouvelle demande de confirmationDésactivation et suppression de la destination d'une règle thématique

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.

Gestion des destinations des règles HTTP thématiques

Vous pouvez utiliser les opérations suivantes pour gérer les destinations de vos règles de HTTP sujet.

Création de destinations de règles HTTP thématiques

Vous créez une destination de règle de HTTP sujet 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 à la confirmationURL. 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

Le nom de la ressource Amazon (ARN) pour la destination de la règle du sujet à 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

Le URL vers lequel vous naviguez pour confirmer la destination d'une règle de sujet.

messageType

Type du message.

Confirmation des destinations des règles de HTTP sujet

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

  1. Confirmez que la destination est prête à 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'ConfirmTopicRuleDestinationAPIopération 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 effectuer l'UpdateTopicRuleDestinationAPIopération 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 sujet dans DISABLED cet état 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.