Criar e excluir rotas e pontos de extremidade usando o portal do Azure

  • Artigo

Este artigo mostra como criar uma rota e um ponto de extremidade em seu hub no Hub IoT do Azure e, em seguida, excluir sua rota e ponto de extremidade. Saiba como usar o portal do Azure para criar rotas e pontos de extremidade para Hubs de Eventos do Azure, filas e tópicos do Barramento de Serviço do Azure, Armazenamento do Azure e Azure Cosmos DB.

Para saber mais sobre como o roteamento funciona no Hub IoT, consulte Usar o roteamento de mensagens do Hub IoT para enviar mensagens do dispositivo para a nuvem para diferentes pontos de extremidade. Para percorrer a configuração de uma rota que envia mensagens para o armazenamento e, em seguida, testar em um dispositivo simulado, consulte Tutorial: Enviar dados do dispositivo para o Armazenamento do Azure usando o roteamento de mensagens do Hub IoT.

Pré-requisitos

Os procedimentos descritos no artigo usam os seguintes recursos:

  • O portal do Azure
  • Um hub IoT
  • Um serviço de ponto de extremidade no Azure

Portal do Azure

Este artigo usa o portal do Azure para trabalhar com o Hub IoT e outros serviços do Azure. Para saber mais sobre como usar o portal do Azure, consulte O que é o portal do Azure?.

Hub IoT

Para criar uma rota de hub IoT, você precisa de um hub IoT criado usando o Hub IoT do Azure. As mensagens e eventos do dispositivo têm origem no seu hub IoT.

Certifique-se de ter o seguinte recurso de hub para usar ao criar sua rota de hub IoT:

Serviço de ponto final

Para criar uma rota de hub IoT, você precisa de pelo menos um outro serviço do Azure para usar como um ponto de extremidade para a rota. O ponto de extremidade recebe mensagens e eventos do dispositivo. Você pode escolher qual serviço do Azure você usa para um ponto de extremidade para se conectar à sua rota de hub IoT: Hubs de Eventos, filas ou tópicos do Service Bus, Armazenamento do Azure ou Azure Cosmos DB.

Certifique-se de ter um dos seguintes recursos para usar ao criar um ponto de extremidade sua rota do hub IoT:

Criar uma rota e um ponto de extremidade

As rotas enviam mensagens ou logs de eventos para um serviço do Azure para armazenamento ou processamento. Cada rota tem uma fonte de dados, onde as mensagens ou logs de eventos se originam, e um ponto de extremidade, onde as mensagens ou logs de eventos terminam. Você pode usar consultas de roteamento para filtrar mensagens ou eventos antes que eles vão para o ponto de extremidade. O ponto de extremidade pode ser um hub de eventos, uma fila ou tópico do Service Bus, uma conta de armazenamento ou um recurso do Azure Cosmos DB.

  1. No portal do Azure, vá para seu hub IoT.

  2. No menu de recursos em Configurações do Hub, selecione Roteamento de mensagens e, em seguida, selecione Adicionar.

    Captura de tela que mostra a localização do botão Adicionar para adicionar uma nova rota em seu hub IoT.

  3. Na guia Ponto de extremidade, selecione um ponto de extremidade existente ou crie um novo fornecendo as seguintes informações:

    Parâmetro Value
    Tipo de ponto final Selecione Cosmos DB.
    Nome do ponto final Forneça um nome exclusivo para um novo ponto de extremidade ou selecione Selecionar existente para escolher um ponto de extremidade de armazenamento existente.
    Conta do Cosmos DB Use o menu suspenso para selecionar uma conta existente do Cosmos DB em sua assinatura.
    Base de dados Use o menu suspenso para selecionar um banco de dados existente em sua conta do Cosmos DB.
    Coleção Use o menu suspenso para selecionar uma coleção (ou contêiner) existente.
    Gerar uma chave de partição sintética para mensagens Selecione Ativar para oferecer suporte ao armazenamento de dados para cenários de alta escala. Caso contrário, selecione Desativar Para obter mais informações, consulte Particionamento e dimensionamento horizontal no Azure Cosmos DB e Chaves de partição sintéticas.
    Nome da chave de partição Se você habilitar chaves de partição sintéticas, forneça um nome para a chave de partição. O nome da propriedade da chave de partição é definido no nível do contêiner e não pode ser alterado depois de definido.
    Modelo de chave de partição Forneça um modelo que é usado para configurar o valor da chave de partição sintética. O valor da chave de partição gerada é adicionado automaticamente à propriedade da chave de partição para cada novo registro do Cosmos DB.

    Captura de tela que mostra detalhes do formulário Adicionar um ponto de extremidade do Cosmos DB.

  1. Selecione Criar + ao lado para criar o ponto de extremidade e continuar a criar uma rota.

  2. Na guia Rota, crie uma nova rota para seu ponto de extremidade fornecendo as seguintes informações:

    Parâmetro Valor
    Nome Forneça um nome exclusivo para a rota.
    Origem de dados Use o menu suspenso para selecionar uma fonte de dados para a rota. Você pode rotear dados de mensagens de telemetria ou eventos que não sejam de telemetria
    Consulta de roteamento Opcionalmente, adicione uma consulta para filtrar os dados antes do roteamento. Para obter mais informações, consulte Sintaxe da consulta de roteamento de mensagens do Hub IoT.

    Captura de tela que mostra todas as opções para adicionar uma rota.

  3. Se você adicionou uma consulta de roteamento, use o recurso Teste para fornecer uma mensagem de exemplo e testar a rota em relação a ela.

  4. Se quiser adicionar um enriquecimento de mensagem à sua rota, selecione Criar + adicionar enriquecimentos. Para obter mais informações, consulte Enriquecimento de mensagens. Caso contrário, selecione Criar + ignorar enriquecimentos.

  5. De volta à visão geral de roteamento de mensagens, confirme se sua nova rota aparece na guia Rotas e se seu novo ponto de extremidade aparece na guia Pontos de extremidade personalizados.

Atualizar uma rota

Para atualizar uma rota no portal do Azure:

  1. No portal do Azure, vá para seu hub IoT.

  2. No menu de recursos em Configurações do Hub, selecione Roteamento de mensagens.

  3. Na guia Rotas, selecione a rota que deseja modificar.

  4. Você pode alterar os seguintes parâmetros de uma rota existente:

    • Ponto de extremidade: você pode criar um novo ponto de extremidade ou selecionar um ponto de extremidade existente diferente.
    • Fonte de dados.
    • Habilite a rota.
    • Consulta de roteamento.

  5. Selecione Guardar.

Excluir uma rota

Para excluir uma rota no portal do Azure:

  1. Em Roteamento de mensagens para seu hub IoT, selecione a rota a ser excluída.

  2. Selecione Eliminar.

    Captura de tela que mostra onde e como excluir uma rota de hub IoT existente.

Atualizar um ponto de extremidade personalizado

Para atualizar um ponto de extremidade personalizado no portal do Azure:

  1. No portal do Azure, vá para seu hub IoT.

  2. No menu de recursos em Configurações do Hub, selecione Roteamento de mensagens.

  3. Na guia Pontos de extremidade personalizados, selecione o ponto de extremidade que você deseja modificar.

  4. Você pode alterar os seguintes parâmetros de um ponto de extremidade existente:

    • Gerar uma chave de partição sintética para mensagens
    • Nome da chave de partição
    • Modelo de chave de partição
  1. Selecione Guardar.

Excluir um ponto de extremidade personalizado

Para excluir um ponto de extremidade personalizado no portal do Azure:

  1. No portal do Azure, vá para seu hub IoT.

  2. No menu de recursos em Configurações do Hub, selecione Roteamento de mensagens.

  3. Na guia Pontos de extremidade personalizados, use a caixa de seleção para selecionar o ponto de extremidade que você deseja excluir.

  4. Selecione Eliminar.

    Captura de tela que mostra onde e como excluir um ponto de extremidade existente dos Hubs de Eventos.

Próximos passos

Para saber mais sobre o roteamento de mensagens, consulte Tutorial: Enviar dados de dispositivo para o Armazenamento do Azure usando o roteamento de mensagens do Hub IoT. No tutorial, você cria uma rota de armazenamento e a testa com um dispositivo em seu hub IoT.