Administrar los destinos de las reglas HTTP temáticas - AWS IoT Core

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.

Administrar los destinos de las reglas HTTP temáticas

Puede utilizar las siguientes operaciones para administrar los destinos de las reglas HTTP temáticas.

Crear destinos de reglas HTTP temáticas

Para crear un destino de regla HTTP temática, 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 confirmaciónURL. 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 regla de tema 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

El lugar URL al que se accede para confirmar el destino de una regla de tema.

messageType

Tipo de mensaje.

Confirmar los destinos de las reglas HTTP temáticas

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 su confirmación URL reciba la solicitud de confirmación.

  1. Confirmación de 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 aparece enableUrl en la solicitud de confirmación o realiza la ConfirmTopicRuleDestination API operación y pasa la confirmationToken de la solicitud de confirmación.

  2. Definición del estado de la regla temática como activado

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

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 del DISABLED estado 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.