Tutorial:r Como enviar uma notificação do Amazon SNS

Crie um tópico do Amazon SNS.

1. Faça login no console do Amazon SNS.

2. No painel de navegação à esquerda, selecione Tópicos.

3. Na página Tópicos, escolha Criar tópico.

4. Em Detalhes, escolha o tipo Padrão. Por padrão, o console cria um tópico FIFO.

5. Em Nome, insira o nome do tópico do SNS. Para este tutorial, insira high_temp_notice.

6. Role até o final do formulário e escolha Criar tópico.

   O console abrirá a página Detalhes do tópico.

Crie uma assinatura do Amazon SNS.

1. Na página de detalhes do tópico high_temp_notice, selecione Criar assinatura.

2. Em Criar assinatura, na seção Detalhes, na lista Protocolo, escolha SMS.

3. No Endpoint, insira o número de um telefone que pode receber mensagens de texto. Certifique-se de inseri-lo de forma que comece com um +, inclua o código do país e da área e não inclua nenhum outro caractere de pontuação.

4. Selecione Criar assinatura.

Teste a notificação do Amazon SNS.

1. No console Amazon SNS , no painel de navegação esquerdo, selecione Tópicos.

2. Para abrir a página de detalhes do tópico, em Tópicos, na lista de tópicos, escolha high_temp_notice.

3. Para abrir a página Publicar mensagem no tópico, na página de detalhes high_temp_notice, selecione Publicar mensagem.

4. Em Publicar mensagem no tópico, na seção Corpo da mensagem, em Corpo da mensagem a ser enviada ao endpoint, insira uma mensagem curta.

5. Navegue para baixo até o final da página e selecione Publicar mensagem.

6. No telefone com o número usado anteriormente ao criar a assinatura, confirme se a mensagem foi recebida.

Se você não recebeu a mensagem de teste, verifique novamente o número de telefone e as configurações do seu telefone.

Certifique-se de poder publicar mensagens de teste no console do Amazon SNS antes de continuar o tutorial.

Abra o hub de regras do AWS IoT console.

Se essa for sua primeira regra, escolha Criar ou Criar uma regra.

Em Criar uma regra:

1. Em Nome, insira temp_limit_notify.

   Lembre-se de que o nome de uma regra deve ser exclusivo em sua região Conta da AWS e não pode ter espaços. Usamos um caractere de sublinhado nesse nome para separar as palavras no nome da regra.

2. Em Descrição, descreva a regra.

   Uma descrição significativa facilita lembrar o que essa regra faz e por que você a criou. A descrição pode ser tão longa quanto necessário, portanto, seja o mais detalhista possível.

Na declaração de consulta de regra de Criar uma regra:

1. Em Uso da versão SQL, selecione 23-03-2016.

2. Na caixa de edição Instrução de consulta de regra, insira a instrução:

   SELECT topic(2) as device_id, 
       temperature as reported_temperature, 
       30 as max_temperature 
     FROM 'device/+/data' 
     WHERE temperature > 30

   Esta declaração:

   • Recebe mensagens MQTT com um tópico que corresponda ao filtro de tópicos device/+/data e que tenha um valor temperature maior que 30.

   • Seleciona o segundo elemento da cadeia de caracteres do tópico e o atribui ao campo device_id.

   • Seleciona o campo temperature de valor da carga útil da mensagem e o atribui ao campo reported_temperature.

   • Cria um valor constante 30 para representar o valor limite e o atribui ao campo max_temperature.

Para abrir a lista de ações de regra para essa regra, em Definir uma ou mais ações, escolha Adicionar ação.

Em Selecionar uma ação, selecione Enviar uma mensagem como uma notificação por push do SNS.

Para abrir a página de configuração da ação selecionada, na parte inferior da lista de ações, escolha Configurar ação.

Em Configurar ação:

1. Em Destino do SNS, escolha Selecionar, encontre seu tópico do SNS chamado high_temp_notice e escolha Selecionar.

2. Em Formato de mensagem, selecione RAW.

3. Em Escolher ou criar uma função para conceder AWS IoT acesso para realizar essa ação, escolha Criar função.

4. Em Criar uma nova função, em Nome, insira um nome exclusivo para a nova função. Para este tutorial, use sns_rule_role.

5. Selecione Criar perfil.

Se estiver repetindo este tutorial ou reutilizando uma função existente, escolha Atualizar função antes de continuar. Isso atualiza o documento de política da função para funcionar com o destino do SNS.

Escolha Adicionar ação e retorne à página Criar uma regra.

No quadro da nova ação, abaixo de Enviar uma mensagem como notificação push do SNS, você pode ver o tópico do SNS que sua regra vai chamar.

Essa é a única ação de regra que você adicionará a essa regra.

Para criar a regra e concluir essa etapa, em Criar uma regra, desloque o cursor para baixo até a parte inferior e escolha Criar regra.

No cliente MQTT no AWS IoT console, assine os tópicos de entrada, neste caso, device/+/data.

1. No Cliente MQTT, em Assinaturas, selecione Assine um tópico.

2. Em Tópico de assinatura, insira o tópico do filtro de tópico de entrada, device/+/data.

3. Deixe os demais campos com as configurações padrão.

4. Escolha Assinar um tópico.

   Na coluna Assinaturas, em Publicar em um tópico, device/+/data é exibido.

Publique uma mensagem no tópico de entrada com um ID de dispositivo específico, device/32/data. Você não pode publicar nos tópicos MQTT que contenham caracteres curinga.

1. No cliente MQTT, em Assinaturas, selecione Publicar em um tópico.

2. No campo Publicar, insira o nome do tópico de entrada, device/32/data.

3. Copie os dados de amostra mostrados aqui e, na caixa de edição abaixo do nome do tópico, cole os dados de amostra.

   {
     "temperature": 38,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

4. Escolha Publicar em um tópico para publicar a mensagem MQTT.

Confirme se a mensagem de texto foi enviada.

1. No cliente MQTT, em Assinaturas, há um ponto verde ao lado do tópico assinado anteriormente.

   O ponto verde indica que uma ou mais mensagens novas foram recebidas desde a última vez que você as visualizou.

2. Em Assinaturas, escolha dispositivo/+/dado para verificar se a carga útil da mensagem corresponde ao que você acabou de publicar e tem a seguinte aparência:

   {
     "temperature": 38,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

3. Verifique o telefone utilizado para assinar o tópico do SNS e confirme se o conteúdo da carga útil da mensagem tem a seguinte aparência:

   {"device_id":"32","reported_temperature":38,"max_temperature":30}

   Observe que o valor device_id valor é uma string citada e o valor temperature é numérico. Isso ocorre porque a topic()função extraiu a string do nome do tópico da mensagem de entrada, enquanto o valor temperature usa o valor numérico da carga útil da mensagem de entrada.

   Se você quiser transformar o valor device_id em um valor numérico, substitua topic(2) na instrução de consulta de regra por:

   cast(topic(2) AS DECIMAL)

   Observe que converter o valor topic(2) em um valor numérico DECIMAL só funcionará se essa parte do tópico contiver somente caracteres numéricos.

Tente enviar uma mensagem MQTT na qual a temperatura não exceda o limite.

1. No cliente MQTT, em Assinaturas, selecione Publicar em um tópico.

2. No campo Publicar, insira o nome do tópico de entrada, device/33/data.

3. Copie os dados de amostra mostrados aqui e, na caixa de edição abaixo do nome do tópico, cole os dados de amostra.

   {
     "temperature": 28,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

4. Para enviar sua mensagem MQTT, escolha Publicar no tópico.

Você deve visualizar a mensagem que enviou na assinatura device/+/data. No entanto, como o valor da temperatura está abaixo da temperatura máxima na consulta da regra, você não deve receber uma mensagem de texto.

Se não encontrar o comportamento correto, confira as dicas de solução de problemas.