Gerenciando destinos de regras de HTTP tópicos

Você pode usar as operações a seguir para gerenciar seus destinos de regras de HTTP tópico.

Criação de destinos de regras de HTTP tópico

Você cria um destino de regra de HTTP tópico chamando a CreateTopicRuleDestination operação ou usando o AWS IoT console.

Depois de criar um destino, AWS IoT envia uma solicitação de confirmação para a confirmaçãoURL. A solicitação de confirmação tem o seguinte 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"
}

O conteúdo do pedido de confirmação inclui as seguintes informações:

arn

O nome do recurso da Amazon (ARN) para confirmar o destino da regra de tópico.

confirmationToken

O token de confirmação enviado por AWS IoT Core. O token no exemplo é truncado. Seu token será mais longo. Você precisará desse token para confirmar seu destino em AWS IoT Core.

enableUrl

O URL até o qual você navega para confirmar o destino de uma regra de tópico.

messageType

O tipo de mensagem.

Confirmando destinos de regras de HTTP tópicos

Para concluir o processo de confirmação do endpoint, se você estiver usando o AWS CLI, execute as etapas a seguir após a confirmação URL receber a solicitação de confirmação.

1. Confirmar se o destino está disposto a receber mensagens

   Para confirmar se o destino da regra de tópico está disposto a receber mensagens de IoT, ligue para a enableUrl na solicitação de confirmação ou execute a ConfirmTopicRuleDestination API operação e passe a confirmationToken partir da solicitação de confirmação.

2. Defina o status da regra de tópico como ativado

   Depois de confirmar que o destino pode receber mensagens, você deve realizar a UpdateTopicRuleDestination API operação para definir o status da regra de tópico comoENABLED.

Se você estiver usando o AWS IoT console, confirmationToken copie e cole na caixa de diálogo de confirmação do destino no AWS IoT console. Em seguida, você pode ativar a regra do tópico.

Enviando uma nova solicitação de confirmação

Para acionar uma nova mensagem de confirmação para um destino, faça uma chamada para UpdateTopicRuleDestination e defina o status do destino da regra de tópico como IN_PROGRESS.

Repita o processo de confirmação depois de enviar uma nova solicitação de confirmação.

Desativando e excluindo um destino de regra de tópico

Para desativar um destino, chame UpdateTopicRuleDestination e defina o status do destino da regra de tópico como DISABLED. Uma regra de tópico no DISABLED estado pode ser ativada novamente sem a necessidade de enviar uma nova solicitação de confirmação.

Para excluir um destino de regra de tópico, faça uma chamada para DeleteTopicRuleDestination.