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.

Destinations d'action HTTP

Une destination d'action HTTP est un service Web vers lequel le moteur de règles peut acheminer les données d'une règle de rubrique. Une AWS IoT Core ressource décrit le service Web pour AWS IoT. Les ressources de destination 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.

Présentation de

Une destination d'action HTTP fait référence à un service Web qui prend en charge une URL de confirmation et une ou plusieurs collectes de données URLs. La ressource de destination contient l'URL de confirmation de votre service Web. Lorsque vous configurez une action 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).

Une destination d'action HTTP peut se trouver dans l'un des états suivants :

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

Gestion des destinations d'action HTTP

Vous pouvez utiliser les opérations suivantes pour gérer vos destinations d'actions HTTP.

Création de destinations d'action HTTP

Vous créez une destination d'action 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 :

Confirmation des destinations d'action 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.

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 d'une destination d'action HTTP

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 d'action HTTP, appelezDeleteTopicRuleDestination.

Support aux autorités de certification

Les points de terminaison HTTPS d'une destination d'action HTTP prennent en charge les certificats émis à la fois par AWS Private Certificate Authority et par Lets Encrypt.