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 :
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\$1COURS
La confirmation de la destination est en cours.
ERROR
La confirmation de la destination a expiré.
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'`CreateTopicRuleDestination`opé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
Le nom de ressource Amazon (ARN) pour la destination de l'action HTTP à 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 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.
1.
**Vérifiez que la destination est prête à recevoir des messages**
Pour confirmer que la destination de l'action HTTP est prête à recevoir des messages IoT, appelez-la `enableUrl` dans la demande de confirmation ou effectuez l'opération `ConfirmTopicRuleDestination` API et transmettez le contenu `confirmationToken` de la demande de confirmation.
1.
**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'`UpdateTopicRuleDestination`API pour définir le statut de la règle du sujet sur`ENABLED`.
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, appelez`DeleteTopicRuleDestination`.
## Support aux autorités de certification
**Note**
Les certificats auto-signés ne sont pas pris en charge.
Les points de terminaison HTTPS d'une destination d'action HTTP prennent en charge les certificats émis à la fois par [AWS Private Certificate Authority](https://www.amazontrust.com/repository/) et par [Lets Encrypt](https://letsencrypt.org/certificates/).