Informazioni di riferimento - Endpoint dell'hub IoTReference - IoT Hub endpoints

Nomi dell'hub IoTIoT Hub names

È possibile trovare il nome dell'hub IoT che ospita gli endpoint nel portale sul pannello Panoramica.You can find the name of the IoT hub that hosts your endpoints in the portal on the Overview blade. Per impostazione predefinita, il nome DNS di un hub IoT è simile al seguente: {your iot hub name}.azure-devices.net.By default, the DNS name of an IoT hub looks like: {your iot hub name}.azure-devices.net.

È possibile usare il DNS di Azure per creare un nome DNS personalizzato per l'hub IoT.You can use Azure DNS to create a custom DNS name for your IoT hub. Per altre informazioni, vedere Usare il servizio DNS di Azure per specificare impostazioni di dominio personalizzate per un servizio di Azure.For more information, see Use Azure DNS to provide custom domain settings for an Azure service.

Elenco di endpoint dell'hub IoT incorporatiList of built-in IoT Hub endpoints

L'hub IoT di Azure è un servizio multi-tenant che espone le proprie funzionalità a diversi attori.Azure IoT Hub is a multi-tenant service that exposes its functionality to various actors. Il diagramma seguente mostra i vari endpoint esposti dall'hub IoT.The following diagram shows the various endpoints that IoT Hub exposes.

Endpoint hub IoT

L'elenco seguente offre una descrizione degli endpoint:The following list describes the endpoints:

  • Provider di risorse.Resource provider. Il provider di risorse dell'hub IoT espone un'interfaccia Azure Resource Manager.The IoT Hub resource provider exposes an Azure Resource Manager interface. Questa interfaccia consente ai proprietari della sottoscrizione di Azure di creare ed eliminare gli hub IoT, nonché di aggiornare le proprietà degli hub IoT.This interface enables Azure subscription owners to create and delete IoT hubs, and to update IoT hub properties. Le proprietà dell'hub IoT disciplinano i criteri di sicurezza a livello di hub, in contrasto con il controllo di accesso a livello di dispositivo, e le opzioni funzionali per la messaggistica da cloud a dispositivo e da dispositivo a cloud.IoT Hub properties govern hub-level security policies, as opposed to device-level access control, and functional options for cloud-to-device and device-to-cloud messaging. Il provider di risorse dell'hub IoT consente anche di esportare le identità dei dispositivi.The IoT Hub resource provider also enables you to export device identities.
  • Gestione delle identità dei dispositivi.Device identity management. Ogni hub IoT espone un set di endpoint REST HTTPS per gestire le identità dei dispositivi (per operazioni di creazione, recupero, aggiornamento ed eliminazione).Each IoT hub exposes a set of HTTPS REST endpoints to manage device identities (create, retrieve, update, and delete). Le identità dei dispositivi vengono usate per l'autenticazione dei dispositivi e il controllo di accesso.Device identities are used for device authentication and access control.
  • Gestione dei dispositivi gemelli.Device twin management. Ogni hub IoT espone un set di endpoint REST HTTPS orientati ai servizi per eseguire query e aggiornare dispositivi gemelli (aggiornare tag e proprietà).Each IoT hub exposes a set of service-facing HTTPS REST endpoint to query and update device twins (update tags and properties).
  • Gestione dei processi.Jobs management. Ogni hub IoT espone un set di endpoint REST HTTPS orientati ai servizi per eseguire query e gestire i processi.Each IoT hub exposes a set of service-facing HTTPS REST endpoint to query and manage jobs.
  • Endpoint del dispositivo.Device endpoints. Per ogni dispositivo nel registro delle identità, l'hub IoT espone un set di endpoint:For each device in the identity registry, IoT Hub exposes a set of endpoints:

    • Invio di messaggi da dispositivo a cloud.Send device-to-cloud messages. Un dispositivo uso questo endpoint per inviare messaggi da dispositivo a cloud.A device uses this endpoint to send device-to-cloud messages.
    • Ricezione di messaggi da cloud a dispositivo.Receive cloud-to-device messages. Il dispositivo usa questo endpoint per ricevere messaggi da cloud a dispositivo specifici.A device uses this endpoint to receive targeted cloud-to-device messages.
    • Avvio di caricamenti di file.Initiate file uploads. Il dispositivo usa questo endpoint per ricevere un URI di firma di accesso condiviso di Archiviazione di Azure dall'hub IoT per il caricamento di un file.A device uses this endpoint to receive an Azure Storage SAS URI from IoT Hub to upload a file.
    • Recuperare e aggiornare le proprietà dei dispositivi gemelli.Retrieve and update device twin properties. Un dispositivo usa questo endpoint per accedere alle relative proprietà del dispositivo gemello.A device uses this endpoint to access its device twin's properties.
    • Ricezione di richieste di metodi diretti.Receive direct method requests. Un dispositivo usa questo endpoint per ascoltare le richieste di metodi diretti.A device uses this endpoint to listen for direct method's requests.

      Questi endpoint vengono esposti con i protocolli MQTT v3.1.1, HTTPS 1.1 e AMQP 1.0.These endpoints are exposed using MQTT v3.1.1, HTTPS 1.1, and AMQP 1.0 protocols. AMQP è disponibile anche su WebSocket sulla porta 443.AMQP is also available over WebSockets on port 443.

  • Endpoint di servizio.Service endpoints. Ogni hub IoT espone un set di endpoint per il back-end della soluzione per comunicare con i dispositivi.Each IoT hub exposes a set of endpoints for your solution back end to communicate with your devices. Con una eccezione, questi endpoint sono esposti solo tramite il protocollo AMQP.With one exception, these endpoints are only exposed using the AMQP protocol. Tramite il protocollo HTTPS viene esposto l'endpoint di chiamata del metodo.The method invocation endpoint is exposed over the HTTPS protocol.

    • Ricezione di messaggi da dispositivo a cloud.Receive device-to-cloud messages. Questo endpoint è compatibile con Hub eventi di AzureThis endpoint is compatible with Azure Event Hubs. e può essere usato da un servizio back-end per leggere i messaggi da dispositivo a cloud inviati dai dispositivi.A back-end service can use it to read the device-to-cloud messages sent by your devices. Oltre a questo endpoint predefinito, è possibile creare endpoint personalizzati sull'hub IoT.You can create custom endpoints on your IoT hub in addition to this built-in endpoint.
    • Invio di messaggi da cloud a dispositivo e ricezione di acknowledgement di recapito.Send cloud-to-device messages and receive delivery acknowledgments. Questi endpoint consentono al back-end della soluzione di inviare messaggi da cloud a dispositivo affidabili e di ricevere gli acknowledgment di recapito o di scadenza corrispondenti.These endpoints enable your solution back end to send reliable cloud-to-device messages, and to receive the corresponding delivery or expiration acknowledgments.
    • Ricezione di notifiche relative ai file.Receive file notifications. Questo endpoint di messaggistica consente di ricevere notifiche quando i dispositivi completano il caricamento di un file.This messaging endpoint allows you to receive notifications of when your devices successfully upload a file.
    • Chiamata diretta al metodo.Direct method invocation. Questo endpoint consente a un servizio back-end di richiamare un metodo diretto in un dispositivo.This endpoint allows a back-end service to invoke a direct method on a device.
    • Ricezione di eventi di monitoraggio delle operazioni.Receive operations monitoring events. Questo endpoint consente di ricevere gli eventi di monitoraggio delle operazioni, se l'hub IoT è stato configurato per generarli.This endpoint allows you to receive operations monitoring events if your IoT hub has been configured to emit them. Per altre informazioni, vedere Monitoraggio delle operazioni dell'hub IoT.For more information, see IoT Hub operations monitoring.

L'articolo Azure IoT SDKs (SDK di IoT di Azure) descrive le varie modalità di accesso a questi endpoint.The Azure IoT SDKs article describes the various ways to access these endpoints.

Tutti gli endpoint dell'hub IoT usano il protocollo TLS e non vengono mai esposti su canali non crittografati o non protetti.All IoT Hub endpoints use the TLS protocol, and no endpoint is ever exposed on unencrypted/unsecured channels.

Endpoint personalizzatiCustom endpoints

È possibile collegare i servizi di Azure esistenti nella sottoscrizione all'hub IoT che agiranno come endpoint per il routing dei messaggi.You can link existing Azure services in your subscription to your IoT hub to act as endpoints for message routing. Questi endpoint agiscono come endpoint di servizio e vengono usati come sink per il ruoting dei messaggi.These endpoints act as service endpoints and are used as sinks for message routes. I dispositivi non possono scrivere direttamente sugli endpoint aggiuntivi.Devices cannot write directly to the additional endpoints. Per ulteriori informazioni sul routing dei messaggi, vedere la voce della guida per gli sviluppatori relativa a invio e ricezione di messaggi con hub IoT.To learn more about message routes, see the developer guide entry on sending and receiving messages with IoT hub.

Hub IoT supporta attualmente i servizi di Azure seguenti come endpoint aggiuntivi:IoT Hub currently supports the following Azure services as additional endpoints:

  • Contenitori di Archiviazione di AzureAzure Storage containers
  • Hub eventiEvent Hubs
  • Code del bus di servizioService Bus Queues
  • Argomenti del bus di servizioService Bus Topics

Hub IoT richiede l'accesso in scrittura a questi endpoint di servizio affinché il routing dei messaggi funzioni correttamente.IoT Hub needs write access to these service endpoints for message routing to work. Se si configurano gli endpoint tramite il Portale di Azure, verranno aggiunte le autorizzazioni necessarie.If you configure your endpoints through the Azure portal, the necessary permissions are added for you. Accertarsi di configurare i servizi per supportare la velocità effettiva prevista.Make sure you configure your services to support the expected throughput. Durante la prima configurazione della soluzione IoT, potrebbe essere necessario monitorare gli endpoint aggiuntivi e quindi apportare le modifiche necessarie per il carico effettivo.When you first configure your IoT solution, you may need to monitor your additional endpoints and make any necessary adjustments for the actual load.

Se un messaggio corrisponde a più percorsi che puntano allo stesso endpoint, hub IoT invia il messaggio a questo endpoint una sola volta.If a message matches multiple routes that all point to the same endpoint, IoT Hub delivers message to that endpoint only once. Pertanto, non è necessario configurare la deduplicazione nella coda o nell'argomento del bus di servizio.Therefore, you do not need to configure deduplication on your Service Bus queue or topic. Nelle code partizionate, l'affinità della partizione garantisce l'ordinamento dei messaggi.In partitioned queues, partition affinity guarantees message ordering.

Per i limiti sul numero di endpoint che è possibile aggiungere, vedere Quotas and throttling (Quote e limitazioni).For the limits on the number of endpoints you can add, see Quotas and throttling.

Uso dei contenitori di Archiviazione di AzureWhen using Azure Storage containers

L'hub IoT supporta solo la scrittura dei dati nei contenitori di Archiviazione di Azure come BLOB nel formato Apache Avro.IoT Hub only supports writing data to Azure Storage containers as blobs in the Apache Avro format. L'hub IoT crea batch di messaggi e scrive i dati in un BLOB non appena raggiunge una determinata dimensione oppure dopo che è trascorso un determinato intervallo di tempo, a seconda dello scenario che si verifica per primo.IoT Hub batches messages and writes data to a blob when it reaches either a certain size or after a certain amount of time has elapsed, whichever happens first. L'hub IoT non scriverà un BLOB vuoto se non sono presenti dati da scrivere.IoT Hub will not write an empty blob if there is no data to write.

Per impostazione predefinita, l'hub IoT usa la convenzione di denominazione di file seguente:IoT Hub defaults to the following file naming convention:

{iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}

È possibile usare la convenzione di denominazione desiderata. È tuttavia necessario usare tutti i token elencati.You may use whatever file naming convention you wish, however you must use all listed tokens.

Uso di code e argomenti del bus di servizioWhen using Service Bus queues and topics

Nelle code e negli argomenti del bus di servizio usati come endpoint dell'hub IoT non devono essere abilitati le sessioni e il rilevamento duplicati.Service Bus queues and topics used as IoT Hub endpoints must not have Sessions or Duplicate Detection enabled. Se una di queste opzioni è abilitata, l'endpoint risulta non raggiungibile nel portale di Azure.If either of those options are enabled, the endpoint appears as Unreachable in the Azure portal.

Gateway sul campoField gateways

In una soluzione IoT un gateway sul campo è posizionato tra i dispositivi e l'hub IoTIn an IoT solution, a field gateway sits between your devices and your IoT Hub endpoints. e in genere si trova vicino ai dispositivi.It is typically located close to your devices. I dispositivi comunicano direttamente con il gateway sul campo tramite un protocollo supportato dai dispositivi.Your devices communicate directly with the field gateway by using a protocol supported by the devices. Il gateway sul campo si connette a un endpoint dell'hub IoT usando un protocollo supportato dall'hub IoT.The field gateway connects to an IoT Hub endpoint using a protocol that is supported by IoT Hub. Un gateway sul campo potrebbe essere un dispositivo hardware dedicato o un computer a bassa potenza che esegue il software del gateway personalizzato.A field gateway might be a dedicated hardware device or a low-power computer running custom gateway software.

È possibile usare Azure IoT Edge per implementare un gateway sul campo.You can use Azure IoT Edge to implement a field gateway. IoT Edge offre funzionalità come il multiplex delle comunicazioni da più dispositivi sulla stessa connessione dell'hub IoT.IoT Edge offers functionality such as multiplexing communications from multiple devices onto the same IoT Hub connection.

Passaggi successiviNext steps

Di seguito sono indicati altri argomenti di riferimento reperibili nella Guida per gli sviluppatori dell'hub IoT:Other reference topics in this IoT Hub developer guide include: