Creare ed eliminare route ed endpoint usando il portale di Azure

  • Articolo

Questo articolo illustra come creare una route e un endpoint nell'hub in hub IoT di Azure e quindi eliminare la route e l'endpoint. Informazioni su come usare il portale di Azure per creare route ed endpoint per Hub eventi di Azure, bus di servizio di Azure code e argomenti, Archiviazione di Azure e Azure Cosmos DB.

Per altre informazioni sul funzionamento del routing in hub IoT, vedere Usare hub IoT routing dei messaggi per inviare messaggi da dispositivo a cloud a endpoint diversi. Per informazioni dettagliate sulla configurazione di una route che invia messaggi all'archiviazione e quindi sui test in un dispositivo simulato, vedere Esercitazione: Inviare dati del dispositivo a Archiviazione di Azure usando hub IoT routing dei messaggi.

Prerequisiti

Le procedure descritte nell'articolo usano le risorse seguenti:

  • Ilportale di Azure
  • Un hub IoT
  • Un servizio endpoint in Azure

Azure portal

Questo articolo usa il portale di Azure per lavorare con hub IoT e altri servizi di Azure. Per altre informazioni su come usare il portale di Azure, vedere Che cos'è il portale di Azure?.

Hub IoT

Per creare una route dell'hub IoT, è necessario un hub IoT creato usando hub IoT di Azure. I messaggi e gli eventi del dispositivo hanno origine nell'hub IoT.

Assicurarsi di avere la risorsa hub seguente da usare quando si crea la route dell'hub IoT:

Servizio endpoint

Per creare una route dell'hub IoT, è necessario almeno un altro servizio di Azure da usare come endpoint per la route. L'endpoint riceve messaggi ed eventi del dispositivo. È possibile scegliere il servizio di Azure usato per un endpoint per connettersi alla route dell'hub IoT: Hub eventi, code o argomenti bus di servizio, Archiviazione di Azure o Azure Cosmos DB.

Assicurarsi di avere una delle risorse seguenti da usare quando si crea un endpoint la route dell'hub IoT:

Creare una route e un endpoint

Instrada i messaggi o i log eventi a un servizio di Azure per l'archiviazione o l'elaborazione. Ogni route ha un'origine dati, in cui hanno origine i messaggi o i registri eventi e un endpoint, in cui i messaggi o i registri eventi finiscono. È possibile usare le query di routing per filtrare i messaggi o gli eventi prima di passare all'endpoint. L'endpoint può essere un hub eventi, una coda o un argomento bus di servizio, un account di archiviazione o una risorsa di Azure Cosmos DB.

  1. Nel portale di Azure passare all'hub IoT.

  2. Nel menu delle risorse in Impostazioni hub selezionare Routing messaggi e quindi Aggiungi.

    Screenshot che mostra la posizione del pulsante Aggiungi per aggiungere una nuova route nell'hub IoT.

  3. Nella scheda Endpoint selezionare un endpoint esistente o crearne uno nuovo specificando le informazioni seguenti:

    Parametro Valore
    Tipo di endpoint Selezionare Cosmos DB.
    Nome endpoint Specificare un nome univoco per un nuovo endpoint oppure selezionare Seleziona esistente per scegliere un endpoint di Archiviazione esistente.
    Account Cosmos DB Usare il menu a discesa per selezionare un account Cosmos DB esistente nella sottoscrizione.
    Database Usare il menu a discesa per selezionare un database esistente nell'account Cosmos DB.
    Raccolta Usare il menu a discesa per selezionare una raccolta esistente (o un contenitore).
    Generare una chiave di partizione sintetica per i messaggi Selezionare Abilita per supportare l'archiviazione dei dati per scenari su larga scala. In caso contrario, selezionare Disabilita per altre informazioni, vedere Partizionamento e scalabilità orizzontale in Azure Cosmos DB e chiavi di partizione sintetica.
    Nome chiave di partizione Se si abilitano le chiavi di partizione sintetica, specificare un nome per la chiave di partizione. Il nome della proprietà della chiave di partizione viene definito a livello di contenitore e non può essere modificato dopo l'impostazione.
    Modello di chiave di partizione Specificare un modello usato per configurare il valore della chiave di partizione sintetica. Il valore della chiave di partizione generato viene aggiunto automaticamente alla proprietà della chiave di partizione per ogni nuovo record Cosmos DB.

    Screenshot che mostra i dettagli del modulo Add a Cosmos DB endpoint (Aggiungi un endpoint Cosmos DB).

  1. Selezionare Crea + accanto per creare l'endpoint e continuare a creare una route.

  2. Nella scheda Route creare una nuova route all'endpoint specificando le informazioni seguenti:

    Parametro valore
    Nome Specificare un nome univoco per la route.
    Origine dati Usare il menu a discesa per selezionare un'origine dati per la route. È possibile instradare i dati dai messaggi di telemetria o da eventi non di telemetria
    Query di routing Facoltativamente, aggiungere una query per filtrare i dati prima del routing. Per altre informazioni, vedere hub IoT sintassi delle query di routing dei messaggi.

    Screenshot che mostra tutte le opzioni per l'aggiunta di una route.

  3. Se è stata aggiunta una query di routing, usare la funzionalità Test per fornire un messaggio di esempio e testarla.

  4. Per aggiungere un arricchimento dei messaggi alla route, selezionare Crea e aggiungi arricchimenti. Per altre informazioni, vedere Arricchimenti dei messaggi. In caso contrario, selezionare Crea e ignora arricchimenti.

  5. Tornare alla panoramica del routing dei messaggi, verificare che la nuova route venga visualizzata nella scheda Route e che il nuovo endpoint venga visualizzato nella scheda Endpoint personalizzati.

Aggiornare una route

Per aggiornare una route nel portale di Azure:

  1. Nel portale di Azure passare all'hub IoT.

  2. Nel menu delle risorse in Impostazioni hub selezionare Routing messaggi.

  3. Nella scheda Route selezionare la route da modificare.

  4. È possibile modificare i parametri seguenti di una route esistente:

    • Endpoint: è possibile creare un nuovo endpoint o selezionare un endpoint esistente diverso.
    • Origine dati.
    • Abilitare la route.
    • Query di routing.

  5. Seleziona Salva.

Eliminare una route

Per eliminare una route nel portale di Azure:

  1. In Routing dei messaggi per l'hub IoT selezionare la route da eliminare.

  2. Selezionare Elimina.

    Screenshot che mostra dove e come eliminare una route dell'hub IoT esistente.

Aggiornare un endpoint personalizzato

Per aggiornare un endpoint personalizzato nel portale di Azure:

  1. Nel portale di Azure passare all'hub IoT.

  2. Nel menu delle risorse in Impostazioni hub selezionare Routing messaggi.

  3. Nella scheda Endpoint personalizzati selezionare l'endpoint da modificare.

  4. È possibile modificare i parametri seguenti di un endpoint esistente:

    • Generare una chiave di partizione sintetica per i messaggi
    • Nome chiave di partizione
    • Modello di chiave di partizione
  1. Seleziona Salva.

Eliminare un endpoint personalizzato

Per eliminare un endpoint personalizzato nel portale di Azure:

  1. Nel portale di Azure passare all'hub IoT.

  2. Nel menu delle risorse in Impostazioni hub selezionare Routing messaggi.

  3. Nella scheda Endpoint personalizzati usare la casella di controllo per selezionare l'endpoint da eliminare.

  4. Selezionare Elimina.

    Screenshot che mostra dove e come eliminare un endpoint di Hub eventi esistente.

Passaggi successivi

Per altre informazioni sul routing dei messaggi, vedere Esercitazione: Inviare dati del dispositivo a Archiviazione di Azure usando hub IoT routing dei messaggi. Nell'esercitazione viene creata una route di archiviazione e testata con un dispositivo nell'hub IoT.