Trabajar con destinos de reglas temática HTTP

El destino de una regla temática 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 de las reglas temáticas 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 del destino de la regla del tema HTTP

El destino de una regla temática HTTP hace referencia a un servicio web que admite una URL de confirmación y una o más URL de recopilación de datos. El recurso de destino de la regla temática HTTP contiene la URL de confirmación de su servicio web. Al configurar una acción de regla temática HTTP, se especifica la URL real del punto de conexión 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).

Un destino de regla temática 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 ENABLED para 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.

EN_PROCESO

La confirmación del destino se está realizando.

ERROR

Se ha agotado el tiempo de espera de confirmación del destino.

Una vez confirmado y habilitado el destino de una regla temática HTTP, puede utilizarse con cualquier regla de su cuenta.

Las siguientes secciones describen acciones comunes en destinos de reglas temáticas HTTP.

Crear y confirmar los destinos de las reglas temáticas HTTP

Para crear un destino de regla temática HTTP, llame a la operación CreateTopicRuleDestination o utilice la consola de AWS IoT .

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 de recurso de Amazon (ARN) para el destino de la regla temática a confirmar.

confirmationToken

El token de confirmación enviado por AWS IoT Core. El token del ejemplo está truncado. Su token será mayor. Necesitarás este token para confirmar tu destino 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.

Para completar el proceso de confirmación del punto de conexión, debe realizar una de las siguientes acciones después de que su URL de confirmación reciba la solicitud de confirmación.

• Llame a la enableUrl en la solicitud de confirmación y, a continuación, llame a la UpdateTopicRuleDestination para establecer el estado de la regla temática en ENABLED.

• Llame a la operación ConfirmTopicRuleDestination y pase el confirmationToken de la solicitud de confirmación.

• Copia confirmationToken y pégalo en el cuadro de diálogo de confirmación del destino en la AWS IoT consola.

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.

Desactivación y eliminación de un destino de regla temática

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 regla del tema, llame a DeleteTopicRuleDestination.