Ler mensagens de dispositivo para a nuvem do ponto de extremidade interno
Por padrão, as mensagens são roteadas para o ponto de extremidade voltado para o serviço interno (mensagens/eventos) compatíveis com Hubs de Eventos. O Hub IoT expõe um ponto de extremidade interno de mensagens/eventos para os serviços de back-end lerem as mensagens de dispositivo para nuvem recebidas por seu hub. Esse ponto de extremidade é compatível com os Hubs de Eventos, o que permite que você use qualquer um dos mecanismos para os quais o serviço Hubs de Eventos dá suporte para ler as mensagens.
Caso esteja usando roteamento de mensagens e a rota de fallback estiver habilitada, uma mensagem que não corresponder a uma consulta em qualquer rota irá para o ponto de extremidade interno. Caso desabilite esta rota de fallback, uma mensagem que não corresponde a nenhuma consulta será descartada.
Esse ponto de extremidade atualmente só é exposto usando o protocolo AMQP na porta 5671 e o AMQP sobre WebSockets na porta 443. Um Hub IoT expõe as propriedades a seguir para permitir que você controle as mensagens/eventos do ponto de extremidade do sistema de mensagens interno compatível com os Hubs de Eventos.
| Propriedade | Descrição |
|---|---|
| Contagem de partição | Defina essa propriedade no momento da criação para determinar o número de partições para inclusão do evento de dispositivo para nuvem. |
| Período de retenção | Essa propriedade especifica por quanto tempo em dias o Hub IoT retém mensagens. O padrão é de um dia, mas pode ser aumentado para sete dias. |
O Hub IoT permite retenção de dados no ponto de extremidade interno por, no máximo, sete dias. Defina o tempo de retenção durante a criação do hub IoT. O tempo de retenção de dados no Hub IoT depende da camada e do tipo de unidade do Hub IoT. Em termos de tamanho, o ponto de extremidade interno pode reter as mensagens do tamanho máximo da mensagem até pelo menos 24 horas de cota. Por exemplo, um hub IoT de unidade S1 fornece armazenamento suficiente para reter pelo menos 400.000 mensagens, a 4 KB por mensagem. Se seus dispositivos enviarem mensagens menores, elas poderão ser retidas por mais tempo (até sete dias), dependendo do consumo de armazenamento. Garantimos a retenção dos dados pelo tempo de retenção especificado como mínimo. Depois que o tempo de retenção tiver passado, as mensagens expirarão e se tornarão inacessíveis. Você pode modificar o tempo de retenção, seja de maneira programática usando as APIs REST do provedor de recursos do Hub IoT ou com o portal do Azure.
O Hub IoT também permite que você gerencie grupos de consumidores no ponto de extremidade interno. Você pode ter até 20 grupos de consumidores para cada hub IoT.
Conectar-se ao ponto de extremidade interno
Algumas integrações do produto e SDKs dos Hubs de Eventos reconhecem o Hub IoT e permitem que você use a cadeia de conexão do serviço do Hub IoT para se conectar ao ponto de extremidade interno.
Quando você usa SDKs de Hubs de Eventos ou integrações de produtos que não reconhecem o Hub IoT, você precisa de um ponto de extremidade compatível com Hubs de Eventos e um nome compatível com Hubs de Eventos. Você pode recuperar esses valores do portal da seguinte maneira:
Entre no Portal do Azure e navegue até o Hub IoT.
Selecione Pontos de extremidade internos no menu de recursos, em Configurações do hub.
O painel de trabalho Pontos de extremidade internos contém três seções:
- A seção Detalhes do Hub de Eventos contém os seguintes valores: Partições, nome compatível com o Hub de Eventos, Reter para e Grupos de Consumidores.
- A seção ponto de extremidade compatível com o Hub de Eventos contém os seguintes valores: Política de acesso compartilhado e Ponto de extremidade compatível com o Hub de Eventos.
- A seção Mensagens de nuvem para dispositivo contém os seguintes valores: TTL padrão, Tempo de retenção de comentários e Contagem máxima de entrega.
No painel de trabalho, o campo do ponto de extremidade compatível com hub de eventos contém uma cadeia de conexão completa dos Hubs de Eventos que se parece com o exemplo a seguir:
Endpoint=sb://abcd1234namespace.servicebus.windows.net/;SharedAccessKeyName=iothubowner;SharedAccessKey=keykeykeykeykeykey=;EntityPath=iothub-ehub-abcd-1234-123456
Se o SDK que você está usando exigir outros valores, eles devem ser:
| Nome | Valor |
|---|---|
| Ponto de extremidade | sb://abcd1234namespace.servicebus.windows.net/ |
| Nome do host | abcd1234namespace.servicebus.windows.net |
| Namespace | abcd1234namespace |
Escolha qualquer política de acesso compartilhado na lista suspensa Política de acesso compartilhado, conforme mostrado na captura de tela anterior. Ela mostra apenas as políticas que têm as permissões do ServiceConnect para se conectar ao hub de eventos especificado.
Exemplos do SDK
Os SDKs que você pode usar para se conectar ao ponto de extremidade compatível com Hubs de Eventos interno que o Hub IoT expõe incluem:
Conectar-se a outros serviços e produtos
As integrações do produto que você pode usar com o ponto de extremidade compatível com Hubs de Eventos interno que o Hub IoT expõe incluem:
-
Para obter mais informações, consulte Associações do Hub IoT para o Azure Functions.
-
Para mais informações, consulte Transmitir dados como entrada no Stream Analytics.
-
Para mais informações, consulte Adicionar uma fonte de evento do Hub IoT ao ambiente do Insight da Série Temporal do Azure.
-
Para obter mais informações, consulte o Guia do desenvolvedor do Apache Kafka para os Hubs de Eventos do Azure.
Próximas etapas
Para saber mais sobre pontos de extremidade do Hub IoT, consulte Pontos de extremidade do Hub IoT.
Se você quiser encaminhar as mensagens de dispositivo para nuvem para pontos de extremidade personalizados, confira Usar rotas de mensagens e pontos de extremidade personalizados para mensagens de dispositivo para nuvem.