Trabajar con destinos de reglas temática HTTP - AWS IoT Core
Descripción general del destino de la regla del tema HTTPCrear destinos de reglas temáticas HTTPConfirmar los destinos de las reglas temáticas HTTPEnviar una nueva solicitud de confirmaciónDesactivación y eliminación de un destino de regla temática

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.

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 destinos de 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.

Confirmar los destinos de las reglas temáticas HTTP

Para completar el proceso de confirmación del punto final, si está utilizando el AWS CLI, debe realizar los siguientes pasos después de que la URL de confirmación reciba la solicitud de confirmación.

  1. Confirma que el destino está dispuesto a recibir mensajes

    Para confirmar que el destino de la regla temática está dispuesto a recibir mensajes de IoT, llama a la que enableUrl aparece en la solicitud de confirmación o realiza la operación de ConfirmTopicRuleDestination API y pasa la confirmationToken de la solicitud de confirmación.

  2. Establece el estado de la regla temática como activado

    Una vez que hayas confirmado que el destino puede recibir mensajes, debes realizar la operación de UpdateTopicRuleDestination API para establecer el estado de la regla de tema 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, puede activar la regla de tema.

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.