Ler mensagens de dispositivo para cloud a partir do ponto final incorporado

Por predefinição, as mensagens são encaminhadas para o ponto final incorporado (mensagens/eventos) que é compatível com os Centros de Eventos. Este ponto final só está atualmente exposto utilizando o protocolo AMQP na porta 5671 e AMQP sobre webSockets na porta 443. Um hub IoT expõe as seguintes propriedades para permitir controlar as mensagens/eventos de mensagens compatíveis com o Event Hub.

Propriedade Descrição
Contagem de divisórias Defina esta propriedade na criação para definir o número de divisórias para ingestão de eventos dispositivo-a-nuvem.
Tempo de retenção Esta propriedade especifica quanto tempo em dias as mensagens são retidas pelo IoT Hub. O incumprimento é um dia, mas pode ser aumentado para sete dias.

O IoT Hub permite a retenção de dados nos Centros de Eventos incorporados por um máximo de 7 dias. Pode definir o tempo de retenção durante a criação do seu Hub IoT. O tempo de retenção de dados no IoT Hub depende do nível do hub IoT e do tipo de unidade. Em termos de tamanho, os Centros de Eventos incorporados podem reter mensagens do tamanho máximo da mensagem até pelo menos 24 horas de quota. Por exemplo, para 1 unidade S1, o IoT Hub fornece armazenamento suficiente para reter pelo menos 400k mensagens de tamanho 4k cada. Se os seus dispositivos estiverem a enviar mensagens mais pequenas, podem ser conservadas por mais tempo (até 7 dias) dependendo da quantidade de armazenamento consumida. Garantimos a retenção dos dados para o tempo de retenção especificado como mínimo. As mensagens caducarão e não serão acessíveis após o tempo de retenção.

O IoT Hub também permite gerir grupos de consumidores no ponto final de receção de dispositivos a nuvem incorporado. Você pode ter até 20 grupos de consumidores para cada IoT Hub.

Se estiver a utilizar o encaminhamento de mensagens e a rota de retorno estiver ativada, todas as mensagens que não correspondam a uma consulta em qualquer rota vão para o ponto final incorporado. Se desativar esta rota de retorno, as mensagens que não correspondem a qualquer consulta são deixadas.

Pode modificar o tempo de retenção, quer programáticamente utilizando o fornecedor de recursos IoT Hub REST APIs,quer com o portal Azure.

O IoT Hub expõe as mensagens/eventos incorporados no ponto final para os seus serviços de back-end para ler as mensagens de dispositivo para nuvem recebidas pelo seu hub. Este ponto final é compatível com o Event Hub, que lhe permite utilizar qualquer um dos mecanismos que o serviço Event Hubs suporta para ler mensagens.

Leia do ponto final incorporado

Algumas integrações de produtos e SDKs de Centros de Eventos estão cientes do IoT Hub e permitem-lhe usar o seu fio de serviço de serviço IoT para ligar ao ponto final incorporado.

Quando utilizar SDKs de Centros de Eventos ou integrações de produtos que não sabem do IoT Hub, precisa de um ponto final compatível com o Event Hub e um nome compatível com o Event Hub. Pode recuperar estes valores do portal da seguinte forma:

  1. Inscreva-se no portal Azure e navegue até ao seu hub IoT.

  2. Clique em pontos finais incorporados.

  3. A secção Eventos contém os seguintes valores: Partições, nome compatível com o Event Hub, ponto final compatível com o Event Hub, Tempo de Retenção e Grupos de Consumidores.

    Configurações dispositivo-a-nuvem

No portal, o campo de ponto final compatível com o Event Hub contém uma cadeia completa de conexão Event Hubs que se parece com: Endpoint=sb://abcd1234namespace.servicebus.windows.net/; SharedAccessKeyName=iothubowner; SharedAccessKey=keykeykeykeykeykey=; EntityPath=iothub-ehub-abcd-1234-123456. Se o SDK que está a usar requer outros valores, então eles seriam:

Name Valor
Ponto final sb://abcd1234namespace.servicebus.windows.net/
Hostname (Nome do anfitrião) abcd1234namespace.servicebus.windows.net
Espaço de Nomes abcd1234namespace

Em seguida, pode escolher qualquer política de acesso partilhado a partir do drop-down, como mostrado na imagem acima. Só mostra políticas que têm as permissões ServiceConnect para ligar ao Centro de Eventos especificado.

Os SDKs que pode utilizar para ligar ao ponto final compatível com o Event Hub que o IoT Hub expõe incluem:

Linguagem SDK Exemplo
.NET https://www.nuget.org/packages/Azure.Messaging.EventHubs Início rápido
Java https://mvnrepository.com/artifact/com.azure/azure-messaging-eventhubs Início rápido
Node.js https://www.npmjs.com/package/@azure/event-hubs Início rápido
Python https://pypi.org/project/azure-eventhub/ Início rápido

As integrações do produto que pode utilizar com o ponto final compatível com o Event Hub que o IoT Hub expõe incluem:

Passos seguintes

Para obter mais detalhes, consulte as mensagens process IoT Hub dispositivo-nuvem usando o tutorial de rotas.