Leggere messaggi da dispositivo a cloud dall'endpoint predefinitoRead device-to-cloud messages from the built-in endpoint

Per impostazione predefinita, i messaggi vengono instradati all'endpoint per servizi predefinito (messaggi/eventi) compatibile con Hub eventi.By default, messages are routed to the built-in service-facing endpoint (messages/events) that is compatible with Event Hubs. Questo endpoint è attualmente esposto solo con il protocollo AMQP sulla porta 5671.This endpoint is currently only exposed using the AMQP protocol on port 5671. Un hub IoT espone le proprietà seguenti per consentire il controllo dell'endpoint di messaggistica predefinito messages/events, compatibile con Hub eventi.An IoT hub exposes the following properties to enable you to control the built-in Event Hub-compatible messaging endpoint messages/events.

ProprietàProperty DescrizioneDescription
Numero di partizioniPartition count Impostare questa proprietà in fase di creazione per definire il numero di partizioni per l'inserimento di eventi da dispositivo a cloud.Set this property at creation to define the number of partitions for device-to-cloud event ingestion.
Tempo di conservazioneRetention time Questa proprietà specifica per quanti giorni i messaggi vengono conservati dall'hub IoT.This property specifies how long in days messages are retained by IoT Hub. Il valore predefinito è un giorno, ma può essere aumentato a sette giorni.The default is one day, but it can be increased to seven days.

L'hub IoT consente inoltre di gestire i gruppi di consumer nell'endpoint di ricezione predefinito da dispositivo a cloud.IoT Hub also enables you to manage consumer groups on the built-in device-to-cloud receive endpoint.

Per impostazione predefinita, tutti i messaggi che non corrispondono in modo esplicito a una regola di routing vengono scritti nell'endpoint predefinito.By default, all messages that do not explicitly match a message routing rule are written to the built-in endpoint. Se si disattiva questa route di fallback, i messaggi che non corrispondono in modo esplicito a una regola di routing verranno eliminati.If you disable this fallback route, messages that do not explicitly match any message routing rules are dropped.

È possibile modificare il tempo di conservazione a livello di codice con le API del provider di risorse dell'hub IoT di Azure oppure usando il portale di Azure.You can modify the retention time, either programmatically through the IoT Hub resource provider REST APIs, or by using the Azure portal.

L'hub IoT espone l'endpoint messaggi/eventi predefinito per permettere ai servizi back-end di leggere i messaggi da dispositivo a cloud ricevuti dall'hub.IoT Hub exposes the messages/events built-in endpoint for your back-end services to read the device-to-cloud messages received by your hub. L'endpoint è compatibile con Hub eventi e consente quindi di usare uno dei meccanismi supportati da tale servizio per la lettura dei messaggi.This endpoint is Event Hub-compatible, which enables you to use any of the mechanisms the Event Hubs service supports for reading messages.

Eseguire la lettura dall'endpoint predefinitoRead from the built-in endpoint

Quando si usa Azure Service Bus SDK per .NET o Hub eventi - Host processore di eventi, è possibile usare qualsiasi stringa di connessione dell'hub IoT con le autorizzazioni corrette.When you use the Azure Service Bus SDK for .NET or the Event Hubs - Event Processor Host, you can use any IoT Hub connection strings with the correct permissions. Usare quindi messaggi/eventi come nome dell'hub eventi.Then use messages/events as the Event Hub name.

Quando si usano gli SDK o le integrazioni del prodotto non compatibili con l'hub IoT, è necessario recuperare un endpoint e un nome compatibili con l'hub eventi dalle impostazioni dell'hub IoT:When you use SDKs (or product integrations) that are unaware of IoT Hub, you must retrieve an Event Hub-compatible endpoint and Event Hub-compatible name from your IoT hub settings:

  1. Accedere al portale di Azure e passare all'hub IoT.Sign in to the Azure portal and navigate to your IoT hub.
  2. Fare clic su Endpoint.Click Endpoints.
  3. Nella sezione Endpoint predefiniti fare clic su Eventi.In the Built-in endpoints section, click Events.
  4. Si apre una pagina delle proprietà che contiene i valori seguenti: endpoint compatibile con l'hub eventi, nome compatibile con l'hub eventi, partizioni, tempo di conservazione e gruppi di consumer.A properties page opens, which contains the following values: Event Hub-compatible endpoint, Event Hub-compatible name, Partitions, Retention time, and Consumer groups.

    Impostazioni da dispositivo a cloud

L'SDK dell'hub IoT richiede il nome dell'endpoint dell'hub IoT, ossia messagi/eventi come mostrato in Endpoint.The IoT Hub SDK requires the IoT Hub endpoint name, which is messages/events as shown under Endpoints.

Se l'SDK usato richiede un valore Nome host o Spazio dei nomi, rimuovere lo schema da Endpoint compatibile con l'hub eventi.If the SDK you are using requires a Hostname or Namespace value, remove the scheme from the Event Hub-compatible endpoint. Ad esempio, se l'endpoint compatibile con l'hub eventi è sb://iothub-ns-myiothub-1234.servicebus.windows.net/, il Nome host sarà iothub-ns-myiothub-1234.servicebus.windows.net.For example, if your Event Hub-compatible endpoint is sb://iothub-ns-myiothub-1234.servicebus.windows.net/, the Hostname would be iothub-ns-myiothub-1234.servicebus.windows.net. Lo spazio dei nomi sarà iothub-ns-myiothub-1234.The Namespace would be iothub-ns-myiothub-1234.

È quindi possibile usare qualsiasi criterio di accesso condiviso con autorizzazioni ServiceConnect per connettersi all'hub eventi specificato.You can then use any shared access policy that has the ServiceConnect permissions to connect to the specified Event Hub.

Se si deve compilare una stringa di connessione dell'hub eventi con le informazioni precedenti, è possibile usare il modello seguente:If you need to build an Event Hub connection string by using the previous information, use the following pattern:

Endpoint={Event Hub-compatible endpoint};SharedAccessKeyName={iot hub policy name};SharedAccessKey={iot hub policy key}

Di seguito sono elencati gli SDK e le integrazioni che è possibile usare con gli endpoint compatibili con l'hub eventi esposti dall'hub IoT:The SDKs and integrations that you can use with Event Hub-compatible endpoints that IoT Hub exposes includes the items in the following list:

Passaggi successiviNext steps

Per altre informazioni sugli endpoint dell'hub IoT, vedere Endpoint dell'hub IoT.For more information about IoT Hub endpoints, see IoT Hub endpoints.

Le esercitazioni introduttive illustrano come inviare messaggi da dispositivo a cloud da dispositivi simulati e leggere i messaggi dall'endpoint predefinito.The Get Started tutorials show you how to send device-to-cloud messages from simulated devices and read the messages from the built-in endpoint. Per altri dettagli, vedere l'esercitazione Elaborare messaggi da dispositivo a cloud dell'hub IoT usando route.For more detail, see the Process IoT Hub device-to-cloud messages using routes tutorial.

Per instradare i messaggi da dispositivo a cloud verso endpoint personalizzati, vedere Use message routes and custom endpoints for device-to-cloud messages (Usare route messaggi ed endpoint personalizzati per i messaggi da dispositivo a cloud).If you want to route your device-to-cloud messages to custom endpoints, see Use message routes and custom endpoints for device-to-cloud messages.