Megosztás a következőn keresztül:


Útvonalak és végpontok létrehozása és törlése az Azure CLI használatával

Ez a cikk bemutatja, hogyan kezelheti az Azure IoT Hub-útvonalakat és -végpontokat az Azure CLI használatával. Megtudhatja, hogyan hozhat létre útvonalakat és végpontokat az Azure CLI használatával az Azure Event Hubshoz, az Azure Service Bus-üzenetsorokhoz és -témakörökhöz, az Azure Storage-hoz és a Cosmos DB-hez.

Az IoT Hubban az útválasztás működésével kapcsolatos további információkért lásd : Az IoT Hub üzenet-útválasztás használata az eszközről a felhőbe irányuló üzenetek különböző végpontokra való küldéséhez. Ha végig szeretne járni egy olyan útvonal beállításán, amely üzeneteket küld a tárolóba, majd szimulált eszközön tesztel, tekintse meg az oktatóanyagot: Eszközadatok küldése az Azure Storage-ba az IoT Hub üzenet-útválasztásával.

Előfeltételek

A cikkben ismertetett eljárások a következő erőforrásokat használják:

  • Azure CLI
  • Egy IoT-központ
  • Végpontszolgáltatás az Azure-ban

Azure CLI

Ez a cikk az Azure CLI-t használja az IoT Hub és más Azure-szolgáltatások használatához. Kiválaszthatja, hogyan érheti el az Azure CLI-t:

IoT Hub

IoT Hubot használ az Azure-előfizetésében. Ha még nem rendelkezik központokkal, kövesse az IoT Hub létrehozása című témakörben leírt lépéseket.

Végpontszolgáltatás

Az útvonal végpontjaként legalább egy másik Azure-szolgáltatásra van szüksége. A végpont eszközüzeneteket és eseménynaplókat fogad.

Döntse el, hogy melyik Azure-szolgáltatást szeretné végpontként használni az irányított eszköz- és eseményadatok fogadásához: eseményközpontot, szolgáltatássort vagy témakört, tárfiókot vagy Cosmos DB-tárolót. A használni kívánt szolgáltatás esetében végezze el a végpontszolgáltatás létrehozásának lépéseit.

  1. Hozzon létre egy Event Hubs-névteret és egy eseményközpontot. További információ : Rövid útmutató: Eseményközpont létrehozása az Azure CLI használatával.

  2. Hozzon létre egy engedélyezési szabályt, amellyel az IoT Hub engedélyt kap az adatok eseményközpontba való küldésére.

    Tipp.

    A name paraméter értéke RootManageSharedAccessKey az alapértelmezett név, amely lehetővé teszi a jogcímek kezelését, küldését, meghallgatását (hozzáférését). Ha korlátozni szeretné a jogcímeket, adja meg a paraméternek a name saját egyedi nevét, és adja meg a --rights jelölőt, amelyet az egyik jogcím követ. Például: --name my-name --rights Send.

    az eventhubs eventhub authorization-rule create --resource-group my-resource-group --namespace-name my-routing-namespace --eventhub-name my-event-hubs --name RootManageSharedAccessKey
    

    További információ: Hozzáférés engedélyezése az Azure Event Hubshoz.

Végpont létrehozása

Minden IoT Hub-útvonal egy végpontra mutat, amely megkapja az irányított eszköz- és eseményadatokat. Több útvonal is ugyanarra a végpontra mutathat. Az IoT Hub jelenleg az Eseményközpontok, a Service Bus-üzenetsorok vagy témakörök, a Storage és a Cosmos DB végpontjait támogatja. A végponthoz használt szolgáltatás egy példányának léteznie kell az Azure-előfizetésben a végpont létrehozása előtt.

Feljegyzés

Ez a cikk az az iot hub message-endpoint parancscsoportot használja, amely az Azure CLI azure-iot bővítményének 0.19.0-s verziójában lett bevezetve. Az azure-iot bővítmény korábbi verziói az az iot hub routing-endpoint parancscsoportot használták, amely hasonló, és továbbra is támogatott, de nem támogatja a Cosmos DB-végpontok létrehozását.

Az azure-iot bővítmény legújabb verziójára az alábbi paranccsal frissíthet:

az extension update --name azure-iot

Event Hubs-végpont létrehozásához használja az előfeltételekben létrehozott engedélyezési szabályt.

  1. Az az eventhubs eventhub authorization-rule keys list paranccsal listázhatja az engedélyezési szabályt. Adja meg a következő értékeket a helyőrző paraméterekhez:

    paraméter Érték
    eventhub_group Az eseményközpont erőforráscsoportja.
    eventhub_namespace Az Event Hubs-névtér neve.
    eventhub_name Az eseményközpont neve.
    rule_name Az eseményközpont engedélyezési szabályának neve. Ha az előfeltételek között másolta a példát, ez a név.RootManageSharedAccessKey
    az eventhubs eventhub authorization-rule keys list --resource-group {eventhub_group} --namespace-name {eventhub_namespace} --eventhub-name my-event-hubs --name {rule_name}
    
  2. Másolja ki az eseményközpontot kapcsolati sztring a kimenetből.

  3. Az egyéni végpont létrehozásához használja az az iot hub message-endpoint create eventhub parancsot. Adja meg a következő értékeket a helyőrző paraméterekhez:

    paraméter Érték
    iothub_name Annak az IoT Hubnak a neve, ahol a végpont létrejön.
    endpoint_name Az új végpont egyedi neve.
    eventhub_subscription Az eseményközpont előfizetés-azonosítója. Ez az argumentum kihagyható, ha az eseményközpont ugyanabban az előfizetésben van, mint az IoT Hub.
    eventhub_group Az eseményközpont erőforráscsoportja. Ez az argumentum kihagyható, ha az eseményközpont ugyanabban az erőforráscsoportban található, mint az IoT Hub.
    eventhub_connection_string Az eseményközpont engedélyezési szabályából másolt kapcsolati sztring.
    az iot hub message-endpoint create eventhub --hub-name {iothub_name} --endpoint-name {endpoint_name}  --connection-string "{eventhub_connection_string}" --endpoint-subscription-id {eventhub_subscription} --endpoint-resource-group {eventhub_group}
    

Végpont törlése

Ha törölni szeretne egy végpontot az IoT Hubról, használja az az iot hub message-endpoint delete parancsot. Ezzel a paranccsal egyetlen végpontot törölhet, egyetlen típusú végpontot törölhet, vagy törölheti az összes végpontot egy központból.

Az alábbi parancs például törli az IoT Hub összes végpontot, amely a Storage-erőforrásokra mutat:

az iot hub message-endpoint delete --hub-name {iothub_name} --endpoint-type storage-container

IoT Hub-útvonal létrehozása

Az IoT Hubban létrehozhat egy útvonalat, amellyel üzeneteket küldhet vagy eseményeket rögzíthet. Minden útvonal rendelkezik adatforrással és végpontokkal. Az adatforrás az, ahonnan üzenetek vagy eseménynaplók származnak. A végponton végződnek az üzenetek vagy az eseménynaplók. Amikor új útvonalat hoz létre az IoT Hubon, kiválaszthatja az adatforrás és a végpont helyét. Igény szerint lekérdezéseket is hozzáadhat az üzenetútvonalakhoz, így szűrheti az üzeneteket vagy eseményeket, mielőtt a végpontra lépnének.

Feljegyzés

Ez a cikk az az iot hub üzenetútvonal-parancscsoportot használja, amely az Azure CLI azure-iot bővítményének 0.19.0-s verziójában lett bevezetve. Az azure-iot bővítmény korábbi verziói az az iot hub route parancscsoportot használták, amely hasonló, és továbbra is támogatott.

Az azure-iot bővítmény legújabb verziójára az alábbi paranccsal frissíthet:

az extension update --name azure-iot
  1. Az az iot Hub message-route create paranccsal hozzon létre egy új IoT Hub-útvonalat a végpont használatával. Adja meg a következő értékeket a helyőrző paraméterekhez:

    paraméter Érték
    iothub_name Annak az IoT Hubnak a neve, ahol ez az útvonal létrejön.
    route_name Az új útvonal egyedi neve.
    endpoint_name Annak a végpontnak a neve, amelybe az útvonal adatokat küld.
    data_source Az útvonal forrása. Az elfogadott értékek a következők: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalidvagy twinchangeevents.
    az iot hub message-route create --hub-name {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source {data_source}
    
  2. Annak ellenőrzéséhez, hogy az új útvonal az IoT Hubban található-e, az az iot hub üzenetútvonal-lista parancsával tekintse meg az IoT Hub összes útvonalát:

    az iot hub message-route list --hub-name {iothub_name}
    

    Az Azure CLI-ben az alábbi példához hasonló válasznak kell megjelennie:

    [
       {
         "condition": "true",
         "endpointNames": [
           "endpoint_name"
         ],
         "isEnabled": true,
         "name": "route_name",
         "source": "DeviceConnectionStateEvents"
       }
    ]
    

IoT Hub-útvonal frissítése

Az útvonal egyes tulajdonságait a létrehozásuk után frissítheti. Módosíthatja egy meglévő útvonal forrását, végpontját, állapotát vagy engedélyezett állapotát.

Az útvonal részleteinek megtekintéséhez használja az az iot hub üzenetútvonal-megjelenítés parancsát.

az iot hub message-route show --hub-name {iothub_name} --route-name {route_name}

Az útvonal tulajdonságainak frissítéséhez használja az az iot hub üzenetútvonal-frissítési parancsát. Az alábbi parancs például frissíti az útvonal forrását.

az iot hub message-route update --hub-name {iothub_name} --route-name {route_name} --source devicejoblifecycleevents

IoT Hub-útvonal törlése

Az az iot hub message-route delete parancsával törölhet egy útvonalat az IoT Hubról.

Az útvonalak törlése nem törli a végpontot, mert más útvonalak ugyanarra a végpontra mutathatnak. Ha törölni szeretne egy végpontot, ezt az útvonal törlésétől elkülönítve teheti meg.

az iot hub message-route delete --hub-name {iothub_name} --route-name {route_name}

A tartalék útvonal kezelése

A tartalék útvonal minden olyan üzenetet küld a forrásból devicemessages , amely nem felel meg a meglévő útvonalak lekérdezési feltételeinek a beépített végpontra.

Az az iot hub message-route fallback show paranccsal megtekintheti az IoT Hub tartalék útvonalának állapotát.

az iot hub message-route fallback show --hub-name {iothub_name}

Az az iot hub message-route tartalékkészlet parancsával engedélyezheti vagy letilthatja a tartalék útvonalat az IoT Hubon.

az iot hub message-route fallback set --hub-name {iothub_name} --enabled {true_false}

Következő lépések

Ebben az útmutatócikkben megtanulta, hogyan hozhat létre útvonalat és végpontot az Event Hubshoz, a Service Bus-üzenetsorokhoz és -témakörökhöz, valamint az Azure Storage-hoz.

Az üzenet-útválasztással kapcsolatos további információkért tekintse meg az oktatóanyagot: Eszközadatok küldése az Azure Storage-ba az IoT Hub üzenet-útválasztásával. Az oktatóanyagban létrehoz egy tárolási útvonalat, és teszteli azt egy eszköz használatával az IoT Hubon.