Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Destinos de acciones HTTP
Un destino de acción HTTP es un servicio web al que el motor de reglas puede enrutar los datos de una regla temática. Un AWS IoT Core recurso describe el servicio web para AWS IoT. Los recursos de destino se pueden compartir mediante diferentes reglas.
Antes de AWS IoT Core poder enviar datos a otro servicio web, debe confirmar que puede acceder al punto final del servicio.
Descripción general de
El destino de una acción HTTP hace referencia a un servicio web que admite una URL de confirmación y una o varias recopilaciones de datos URLs. El recurso de destino contiene la URL de confirmación de su servicio web. Al configurar una acción HTTP, se especifica la URL real del punto final que debe recibir los datos junto con la URL de confirmación del servicio web. Una vez confirmado el destino, la regla temática envía el resultado de la sentencia SQL al punto de conexión HTTPS (y no a la URL de confirmación).
El destino de una acción HTTP puede estar en uno de los siguientes estados:
- ENABLED
-
El destino se ha confirmado y se puede utilizar mediante una acción de regla. Un destino debe tener el estado
ENABLEDpara que se utilice en una regla. Solo puede habilitar destinos con el estado DISABLED. - DISABLED
-
El destino se ha confirmado y se puede utilizar mediante una acción de regla. Esto es útil si desea impedir temporalmente el tráfico a su punto de conexión sin tener que pasar de nuevo por el proceso de confirmación. Solo puede deshabilitar un destino con el estado ENABLED.
- IN_PROGRESS
-
La confirmación del destino se está realizando.
- ERROR
-
Se ha agotado el tiempo de espera de confirmación del destino.
Una vez que se haya confirmado y habilitado el destino de una acción HTTP, se puede usar con cualquier regla de tu cuenta.
Administrar los destinos de acciones HTTP
Puede utilizar las siguientes operaciones para gestionar los destinos de sus acciones HTTP.
Crear destinos de acción HTTP
Para crear un destino de acción HTTP, llame a la CreateTopicRuleDestination operación o utilice la AWS IoT consola.
Tras crear un destino, AWS IoT envía una solicitud de confirmación a la URL de confirmación. La solicitud de confirmación tiene el siguiente formato:
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" }
El contenido de la solicitud de confirmación incluye la siguiente información:
- arn
-
El nombre del recurso de Amazon (ARN) del destino de la acción HTTP a confirmar.
- confirmationToken
-
El token de confirmación enviado por AWS IoT Core. El token del ejemplo está truncado. Su token será mayor. Necesitará este token para confirmar su destino con AWS IoT Core.
- enableUrl
-
La dirección URL a la que se desplaza para confirmar el destino de una regla del tema.
- messageType
-
Tipo de mensaje.
Confirmar los destinos de las acciones HTTP
Para completar el proceso de confirmación del punto de conexión, si utiliza la AWS CLI, debe realizar uno de los siguientes pasos después de que su URL de confirmación reciba la solicitud de confirmación.
-
Confirme que el destino está listo para recibir mensajes
Para confirmar que el destino de la acción HTTP está listo para recibir mensajes de IoT, llama a la que
enableUrlaparece en la solicitud de confirmación o realiza la operación deConfirmTopicRuleDestinationAPI y pasa laconfirmationTokende la solicitud de confirmación. -
Definición del estado de la regla temática como activado
Después de confirmar que el destino puede recibir mensajes, debe ejecutar la operación de la API
UpdateTopicRuleDestinationpara establecer el estado de la regla temática enENABLED.
Si utilizas la AWS IoT consola, cópiala confirmationToken y pégala en el cuadro de diálogo de confirmación del destino en la AWS IoT consola. A continuación, ya podrá activar la regla temática.
Enviar una nueva solicitud de confirmación
Para activar un nuevo mensaje de confirmación para un destino, llame a UpdateTopicRuleDestination y establezca el estado del destino de la regla del tema en IN_PROGRESS.
Repita el proceso de confirmación después de enviar una nueva solicitud de confirmación.
Deshabilitar y eliminar un destino de acción HTTP
Para deshabilitar un destino, llame a UpdateTopicRuleDestination y establezca el estado del destino de la regla del tema en DISABLED. Una regla temática en estado DESACTIVADO se puede volver a activar sin necesidad de enviar una nueva solicitud de confirmación.
Para eliminar un destino de acción HTTP, llamaDeleteTopicRuleDestination.
Certificate Authority Support
nota
No se admiten los certificados autofirmados.
Los puntos de enlace HTTPS de un destino de acción HTTP admiten certificados emitidos tanto por AWS Private Certificate Authority
