Esaminare l'endpoint predefinito dell’hub IoT
Per impostazione predefinita, i messaggi vengono instradati all'endpoint per servizi predefinito (messaggi/eventi) compatibile con Hub eventi. Questo endpoint viene attualmente esposto solo usando il protocollo AMQP sulla porta 5671 e AMQP su WebSockets sulla porta 443. Un hub IoT di Azure espone le proprietà seguenti per consentire il controllo dell'endpoint predefinito.
Proprietà
Descrizione
Numero di partizioni
Impostare questa proprietà in fase di creazione per definire il numero di partizioni per l'inserimento di eventi da dispositivo a cloud.
Tempo di conservazione
Questa proprietà specifica per quanto tempo in giorni i messaggi vengono conservati dall'hub IoT di Azure. Il valore predefinito è un giorno, ma può essere aumentato a sette giorni.
L'hub IoT di Azureconsente la conservazione dei dati nell'endpoint predefinito per un massimo di sette giorni. È possibile impostare il tempo di conservazione durante la creazione dell'hub IoT di Azure. Il tempo di conservazione dei dati nell'hub IoT di Azure dipende dal livello e dal tipo di unità dell'hub IoT di Azure. In termini di dimensioni, l'endpoint Hub eventi predefinito può conservare i messaggi di dimensione massima fino ad almeno 24 ore di quota. Ad esempio, per 1 unità S1 l'hub IoT di Azure fornisce spazio di archiviazione sufficiente per conservare almeno 400 mila messaggi di dimensioni 4k ciascuno. Se i dispositivi inviano messaggi più brevi, è possibile che vengano conservati più a lungo (fino a sette giorni), a seconda della quantità di memoria utilizzata. Microsoft garantisce la conservazione dei dati come minimo per il tempo di conservazione specificato.
L'hub IoT di Azure consente anche di gestire i gruppi di consumer nell'endpoint di ricezione da dispositivo a cloud predefinito. È possibile disporre di un massimo di 20 gruppi di consumer per ogni hub IoT di Azure.
Se si usa il routing dei messaggi e la route di fallback è abilitata, tutti i messaggi che non corrispondono a una query in una route vengono indirizzati all'endpoint predefinito. Se si disabilita la route di fallback, i messaggi che non corrispondono a una query vengono eliminati.
È possibile modificare il tempo di conservazione, sia in modo programmatico usando le API REST del provider di risorse dell'hub IoT di Azure, sia tramite il portale di Azure.
L'hub IoT di Azure espone l'endpoint predefinito messaggi/eventi per i servizi back-end per leggere i messaggi da dispositivo a cloud ricevuti dall'hub. L'endpoint è compatibile con Hub eventi e consente quindi di usare uno dei meccanismi supportati da tale servizio per la lettura dei messaggi.
Eseguire la lettura dall'endpoint predefinito
Alcune integrazioni del prodotto e SDK di Hub eventi sono in grado di riconoscere l'hub IoT di Azure e consentono di usare la stringa di connessione del servizio hub IoT di Azure per connettersi all'endpoint predefinito.
Quando si usano gli SDK di Hub eventi o le integrazioni del prodotto che non rilevano l'hub IoT di Azure, sono necessari un endpoint e un nome compatibili con Hub eventi. È possibile recuperare questi valori dal servizio hub IoT di Azure nel portale di Azure aprendo il riquadro Endpoint predefiniti.
La sezione Dettagli hub eventi contiene i valori seguenti: Partizioni, nome compatibile con Hub eventi, endpoint compatibile con Hub eventi, Conservazione per e Gruppi di consumer.
Nel portale il campo Endpoint compatibile con l'hub eventi contiene una stringa di connessione completa di Hub eventi simile a: Endpoint=sb://abcd1234namespace.servicebus.windows.net/;SharedAccessKeyName=iothubowner;SharedAccessKey=keykeykeykeykeykey=;EntityPath=iothub-ehub-abcd-1234-123456. Se per l'SDK in uso sono necessari altri valori, corrisponderanno a quanto segue:
Nome
valore
Endpoint
sb://abcd1234namespace.servicebus.windows.net/
Hostname (Nome host)
abcd1234namespace.servicebus.windows.net
Spazio dei nomi
abcd1234namespace
È quindi possibile usare qualsiasi criterio di accesso condiviso con autorizzazioni ServiceConnect per connettersi all'hub eventi specificato.
Gli SDK che è possibile usare per connettersi all'endpoint compatibile con l'hub eventi predefinito che l'hub IoT di Azure espone includono:
Lingua
SDK
Esempio
Note
.NET
Usa informazioni compatibili con Hub eventi
Java
Usa informazioni compatibili con Hub eventi
Node.js
Usa la stringa di connessione dell'hub IoT di Azure
Python
Usa la stringa di connessione dell'hub IoT di Azure
Le integrazioni del prodotto che è possibile usare per connettersi all'endpoint compatibile con l'hub eventi predefinito che l'hub IoT di Azure espone includono:
- Funzioni di Azure
- Analisi di flusso di Azure
- Time Series Insights
- Spout di Apache Storm
- Integrazione con Apache Spark
- Azure Databricks