Skapa och ta bort vägar och slutpunkter med hjälp av Azure-portalen

Den här artikeln visar hur du skapar en väg och slutpunkt i din hubb i Azure IoT Hub och sedan tar bort din väg och slutpunkt. Lär dig hur du använder Azure-portalen för att skapa vägar och slutpunkter för Azure Event Hubs, Azure Service Bus-köer och -ämnen, Azure Storage och Azure Cosmos DB.

Mer information om hur routning fungerar i IoT Hub finns i Använda IoT Hub-meddelanderoutning för att skicka meddelanden från enhet till moln till olika slutpunkter. Information om hur du konfigurerar en väg som skickar meddelanden till lagring och sedan testar på en simulerad enhet finns i Självstudie: Skicka enhetsdata till Azure Storage med hjälp av IoT Hub-meddelanderoutning.

Förutsättningar

De procedurer som beskrivs i artikeln använder följande resurser:

  • Azure-portalen
  • En IoT Hub
  • En slutpunktstjänst i Azure

Azure Portal

Den här artikeln använder Azure-portalen för att arbeta med IoT Hub och andra Azure-tjänster. Mer information om hur du använder Azure-portalen finns i Vad är Azure-portalen?.

IoT-nav

För att skapa en IoT Hub-väg behöver du en IoT-hubb som du skapade med hjälp av Azure IoT Hub. Enhetsmeddelanden och händelser kommer från din IoT-hubb.

Se till att ha följande hubbresurs att använda när du skapar din IoT Hub-väg:

Slutpunktstjänst

Om du vill skapa en IoT Hub-väg behöver du minst en annan Azure-tjänst som ska användas som slutpunkt till vägen. Slutpunkten tar emot enhetsmeddelanden och händelser. Du kan välja vilken Azure-tjänst du använder för en slutpunkt för att ansluta till din IoT Hub-väg: Event Hubs, Service Bus-köer eller -ämnen, Azure Storage eller Azure Cosmos DB.

Se till att du har någon av följande resurser att använda när du skapar en slutpunkt för din IoT Hub-väg:

Skapa en väg och en slutpunkt

Vägar skickar meddelanden eller händelseloggar till en Azure-tjänst för lagring eller bearbetning. Varje väg har en datakälla, där meddelandena eller händelseloggarna kommer och en slutpunkt, där meddelandena eller händelseloggarna hamnar. Du kan använda routningsfrågor för att filtrera meddelanden eller händelser innan de går till slutpunkten. Slutpunkten kan vara en händelsehubb, en Service Bus-kö eller ett ämne, ett lagringskonto eller en Azure Cosmos DB-resurs.

  1. Gå till din IoT-hubb i Azure-portalen.

  2. På resursmenyn under Hubbinställningar väljer du Meddelanderoutning och sedan Lägg till.

    Skärmbild som visar platsen för knappen Lägg till för att lägga till en ny väg i din IoT-hubb.

  3. På fliken Slutpunkt väljer du en befintlig slutpunkt eller skapar en ny genom att ange följande information:

    Parameter Värde
    Slutpunktstyp Välj Cosmos DB.
    Slutpunktsnamn Ange ett unikt namn för en ny slutpunkt eller välj Välj befintlig för att välja en befintlig lagringsslutpunkt.
    Cosmos DB-konto Använd den nedrullningsbara menyn för att välja ett befintligt Cosmos DB-konto i din prenumeration.
    Databas Använd den nedrullningsbara menyn för att välja en befintlig databas i ditt Cosmos DB-konto.
    Samling Använd den nedrullningsbara menyn för att välja en befintlig samling (eller container).
    Generera en syntetisk partitionsnyckel för meddelanden Välj Aktivera för att stödja datalagring för storskaliga scenarier. Annars väljer du Inaktivera Mer information finns i Partitionering och horisontell skalning i Azure Cosmos DB och Syntetiska partitionsnycklar.
    Partitionsnyckelnamn Om du aktiverar syntetiska partitionsnycklar anger du ett namn för partitionsnyckeln. Egenskapsnamnet för partitionsnyckeln definieras på containernivå och kan inte ändras när det har angetts.
    Mall för partitionsnyckel Ange en mall som används för att konfigurera värdet för den syntetiska partitionsnyckeln. Det genererade partitionsnyckelvärdet läggs automatiskt till i partitionsnyckelegenskapen för varje ny Cosmos DB-post.

    Skärmbild som visar information om formuläret Lägg till en Cosmos DB-slutpunkt.


  1. Välj Skapa + bredvid för att skapa slutpunkten och fortsätt att skapa en väg.

  2. På fliken Väg skapar du en ny väg till slutpunkten genom att ange följande information:

    Parameter Värde
    Namn Ange ett unikt namn för vägen.
    Datakälla Använd den nedrullningsbara menyn för att välja en datakälla för vägen. Du kan dirigera data från telemetrimeddelanden eller icke-telemetrihändelser
    Routningsfråga Du kan också lägga till en fråga för att filtrera data före routning. Mer information finns i Frågesyntax för IoT Hub-meddelanderoutning.

    Skärmbild som visar alla alternativ för att lägga till en väg.

  3. Om du har lagt till en routningsfråga använder du funktionen Test för att tillhandahålla ett exempelmeddelande och testa vägen mot den.

  4. Om du vill lägga till en meddelandeberikning i din väg väljer du Skapa + lägg till berikanden. Mer information finns i Meddelandeberikningar. Om inte väljer du Skapa + hoppa över berikanden.

  5. I översikten över meddelanderoutning bekräftar du att den nya vägen visas på fliken Vägar och att den nya slutpunkten visas på fliken Anpassade slutpunkter .

Uppdatera en väg

Så här uppdaterar du en väg i Azure-portalen:

  1. Gå till din IoT-hubb i Azure-portalen.

  2. På resursmenyn under Hubbinställningar väljer du Meddelanderoutning.

  3. På fliken Vägar väljer du den väg som du vill ändra.

  4. Du kan ändra följande parametrar för en befintlig väg:

    • Slutpunkt: Du kan skapa en ny slutpunkt eller välja en annan befintlig slutpunkt.
    • Datakälla.
    • Aktivera väg.
    • Routningsfråga.
  5. Välj Spara.

Ta bort en väg

Så här tar du bort en väg i Azure-portalen:

  1. I Meddelanderoutning för din IoT-hubb väljer du den väg som ska tas bort.

  2. Välj Ta bort.

    Skärmbild som visar var och hur du tar bort en befintlig IoT Hub-väg.

Uppdatera en anpassad slutpunkt

Så här uppdaterar du en anpassad slutpunkt i Azure-portalen:

  1. Gå till din IoT-hubb i Azure-portalen.

  2. På resursmenyn under Hubbinställningar väljer du Meddelanderoutning.

  3. På fliken Anpassade slutpunkter väljer du den slutpunkt som du vill ändra.

  4. Du kan ändra följande parametrar för en befintlig slutpunkt:

    • Generera en syntetisk partitionsnyckel för meddelanden
    • Partitionsnyckelnamn
    • Mall för partitionsnyckel

  1. Välj Spara.

Ta bort en anpassad slutpunkt

Så här tar du bort en anpassad slutpunkt i Azure-portalen:

  1. Gå till din IoT-hubb i Azure-portalen.

  2. På resursmenyn under Hubbinställningar väljer du Meddelanderoutning.

  3. På fliken Anpassade slutpunkter använder du kryssrutan för att välja den slutpunkt som du vill ta bort.

  4. Välj Ta bort.

    Skärmbild som visar var och hur du tar bort en befintlig Event Hubs-slutpunkt.

Nästa steg

Mer information om meddelanderoutning finns i Självstudie: Skicka enhetsdata till Azure Storage med hjälp av IoT Hub-meddelanderoutning. I självstudien skapar du en lagringsväg och testar den med en enhet i din IoT-hubb.