Ú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:
Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.
Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.
Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.
Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.
Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.
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.
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.
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ékeRootManageSharedAccessKey
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 aname
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.
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}
Másolja ki az eseményközpontot kapcsolati sztring a kimenetből.
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
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
,invalid
vagytwinchangeevents
.az iot hub message-route create --hub-name {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source {data_source}
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.