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


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

Ez a cikk bemutatja, hogyan exportálhatja az Azure IoT Hub-sablont, hogyan adhat hozzá útvonalat az IoT Hubhoz, majd hogyan helyezheti üzembe újra a sablont az IoT Hubon az Azure CLI vagy az Azure PowerShell használatával. Útvonalak és végpontok létrehozásához használjon Azure Resource Manager-sablont. Az IoT Hub végpontként az alábbi Azure-szolgáltatásokat támogatja:

  • Tárolók
  • Event Hubs
  • Service Bus-üzenetsorok
  • Service Bus-témakörök
  • Cosmos DB

Az Azure Resource Manager-sablonok akkor hasznosak, ha JSON-fájl használatával szeretne erőforrásokat definiálni. Minden Azure-erőforráshoz tartozik egy sablon, amely meghatározza az adott erőforrásban használt összetevőket. Exportálhatja az összes Azure-erőforrássablont.

Fontos

Amikor Resource Manager-sablont használ egy erőforrás üzembe helyezéséhez, a sablon lecseréli az üzembe helyezni kívánt típusú meglévő erőforrásokat.

Új IoT Hub létrehozásakor nem kell felülírni egy meglévő üzembe helyezett erőforrást. Új IoT Hub létrehozásához használhat olyan alapszintű sablont , amely rendelkezik a szükséges tulajdonságokkal ahelyett, hogy egy már üzembe helyezett IoT Hubból exportálná a meglévő sablont.

Ha azonban útvonalat ad hozzá egy meglévő IoT Hubhoz, használjon egy olyan sablont, amelyet exportál az IoT Hubról annak biztosítására, hogy a frissített sablon üzembe helyezése után minden meglévő erőforrás és tulajdonság csatlakoztatva maradjon. A már üzembe helyezett erőforrások nem lesznek lecserélve. Például egy korábban üzembe helyezett exportált Resource Manager-sablon tartalmazhat tárolási információkat az IoT Hubhoz, ha csatlakoztatta azt a tárolóhoz.

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. Az üzeneteket tároló, majd szimulált eszközön tesztelő útvonal beállításának lépéseit a következő oktatóanyagban tekintheti meg: Eszközadatok küldése az Azure Storage-ba az IoT Hub üzenet-útválasztásával.

Előfeltételek

Tekintse át a cikk előfeltételeit annak alapján, hogy milyen típusú végpontra szeretné irányítani az üzeneteket.

Azure Resource Manager-sablon

Ez a cikk egy Azure Resource Manager-sablont használ az Azure Portalon az IoT Hub és más Azure-szolgáltatások használatához. További információ a Resource Manager-sablonok használatáról: Mik azok az Azure Resource Manager-sablonok?

Ú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. Ezután útválasztási lekérdezésekkel szűrheti az üzeneteket vagy eseményeket, mielőtt azok a végpontra kerülnének.

Az IoT Hub-útvonal végpontjaként használhat eseményközpontot, Service Bus-üzenetsort vagy -témakört vagy Azure Storage-fiókot. A végpont létrehozásához használt szolgáltatásnak először az Azure-fiókjában kell lennie.

Az IoT Hub Resource Manager-sablonjának exportálása

Először exportáljon egy Resource Manager-sablont az IoT Hubról. Ha exportálja a sablont az IoT Hubról, hozzáadhat végpontokat és irányíthatja az erőforrásokat, és újra üzembe helyezheti anélkül, hogy elveszítené a meglévő beállítást.

  1. Az Azure Portalon nyissa meg az IoT Hubot. Az Automation erőforrásmenüjében válassza az Exportálás sablon lehetőséget.

    Képernyőkép az Exportálás sablonbeállítás helyéről egy IoT Hub-erőforrás menüjében.

  2. Az Exportálás sablonban a Sablon lapon hajtsa végre az alábbi lépéseket:

    1. Tekintse meg az IoT Hubhoz létrehozott JSON-fájlt.

    2. Törölje a jelet a Paraméterek belefoglalása jelölőnégyzetből .

    3. Válassza a Letöltés lehetőséget a JSON-fájl helyi másolatának letöltéséhez.

    Képernyőkép a Letöltés gomb helyéről az Exportálás sablonpanelen.

    A sablon számos helyőrzőt tartalmaz, amelyekkel szolgáltatásokat vagy szolgáltatásokat adhat hozzá az IoT Hubhoz. Ebben a cikkben csak azokhoz a tulajdonságokhoz adjon hozzá értékeket, amelyek a következőkben routingtalálhatók vagy vannak beágyazva.

Végpont hozzáadása a sablonhoz

Minden útvonal egy végpontra mutat, ahol az üzenetek vagy az eseménynaplók végződnek. Hozzon létre egy végpontot az IoT Hubon, amelyre az útvonal hivatkozhat. Az IoT Hub-útvonal végpontjaként használhat eseményközpontot, Service Bus-üzenetsort vagy -témakört, Azure-tárfiókot vagy Cosmos DB-tárolót. A végpont létrehozásához használt szolgáltatásnak először az Azure-fiókjában kell lennie.

Az IoT Hubnak hozzáférési engedélyekre van szüksége minden olyan végponterőforráshoz, amelybe üzeneteket vagy naplókat küld. Hozzáférést felügyelt identitásokkal és Microsoft Entra-azonosítóval vagy kapcsolati sztring használatával biztosíthat. A Microsoft azt javasolja, hogy az Entra-azonosítóval való hitelesítés a biztonságosabb megoldás.

Adjon hozzá egy Event Hubs-végpontot a Resource Manager-sablonhoz. További információ: Azure Resource Manager-sablon RoutingEventHubProperties.

  1. A JSON-fájlban keresse meg az "endpoints": [] alá "routing"ágyazott tulajdonságot.

  2. Cserélje le a "endpoints": [] sort a következő JSON-ra:

    "endpoints": {
        "serviceBusQueues": [],
        "serviceBusTopics": [],
        "eventHubs": [
            {
                "endpointUri": "",
                "entityPath": "",
                "authenticationType": "identityBased",
                "identity": {
                    "userAssignedIdentity": ""
                },
                "name": "",
                "id": "",
                "subscriptionId": "",
                "resourceGroup": ""
            }
        ],
        "storageContainers": [],
        "cosmosDBSqlContainers": []
    },
    
  3. Frissítse a JSON-t a következő információkkal az Event Hubs-erőforrásról:

    Tulajdonság Érték
    endpointUri (Ha a hitelesítési típus ; identityBased egyéb esetben törölje.) Az Event Hubs-névtér gazdagépneve a formátumban sb://<eventhubs_namespace_name>.servicebus.windows.net
    entityPath (Ha a hitelesítési típus ; identityBased egyéb esetben törölje.) Az eseményközpont neve.
    authenticationType identityBased vagy keyBased. A Microsoft az identitásalapú hitelesítést javasolja biztonságosabb megoldásként.
    identitás (Ha a identityBasedhitelesítési típus .) Használhat felhasználó által hozzárendelt felügyelt identitást vagy rendszer által hozzárendelt felügyelt identitást, ha az IoT Hubon engedélyezve van a rendszer által hozzárendelt felügyelt identitás.

    Felhasználó által hozzárendelt: A felügyelt identitás külső azonosítója, amely hozzáférési engedélyekkel rendelkezik az eseményközponthoz a formátumban /subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity_name>.

    Rendszer által hozzárendelt: Hagyja üres listaként az identitásparamétert. Például: "identity": {},
    connectionString (Ha a keyBasedhitelesítési típus .) Az elsődleges kapcsolati sztring az eseményközpont egyik megosztott hozzáférési szabályzatából a következő formátumban<connection_string>;EntityPath=<event_hub_name>.: Lekérheti a kapcsolati sztring értéket az Azure Portalról, majd hozzáfűzheti az entitás elérési útját.
    név Adjon meg egy egyedi értéket a végpont elnevezéséhez.
    id Hagyja üres sztringként. Az Azure szolgáltatás értéket biztosít a végpont létrehozásakor.
    subscriptionId Az eseményközpontot tartalmazó előfizetés azonosítója.
    resourceGroup Az eseményközpontot tartalmazó erőforráscsoport neve.

    Tipp.

    Titkos kódok kezeléséhez létrehozhat egy paraméterfájlt, vagy az Azure Key Vault használatával biztonságos paraméterértékeket adhat át az üzembe helyezés során.

Útvonal hozzáadása a sablonhoz

Adjon hozzá útvonaldefiníciót a Resource Manager-sablonhoz. További információkért tekintse meg az Azure Resource Manager RouteProperties sablonját.

  1. A JSON-fájlban keresse meg az "routes": [] alá "routing"ágyazott tulajdonságot, és adjon hozzá egy új útvonalat.

    Figyelemfelhívás

    Ha a meglévő értékeket "routes" az alábbi kód példákban használt útvonalértékekre cseréli, a rendszer az üzembe helyezéskor eltávolítja a meglévő útvonalakat. A meglévő útvonalak megőrzéséhez adja hozzá az új útvonalobjektumot a "routes" listához.

    "routes": [
        {
            "name": "",
            "source": "DeviceConnectionStateEvents",
            "condition": "true",
            "endpointNames": [
                ""
            ],
            "isEnabled": true
        }
    ],
    
  2. Frissítse a JSON-t az alábbi információkkal a Cosmos DB-erőforrásról:

    Tulajdonság Érték
    név Adjon meg egy egyedi értéket az útvonal elnevezéséhez.
    forrás Válassza ki az üzenet vagy eseménynaplók forrását a végpontra való átirányításhoz. A forrásbeállítások listáját az az iot hub route című témakörben találja.
    feltétel A forrásadatok szűrésére szolgáló lekérdezés. Ha nincs szükség feltételre, mondjuk true. További információ: IoT Hub üzenet-útválasztási lekérdezés szintaxisa.
    endpointNames Annak a meglévő végpontnak a neve, ahol az adatok átirányításra kerülnek. Jelenleg csak egy végpont engedélyezett.
    isEnabled true Állítsa be az útvonal engedélyezésére vagy false az útvonal letiltására.
  3. Mentse a JSON-fájlt.

A Resource Manager-sablon üzembe helyezése

A Resource Manager-sablonhoz hozzáadott új végpont és útvonal mostantól újra üzembe helyezheti a JSON-fájlt az IoT Hubon.

Helyi üzembe helyezés

az deployment group create \
  --name my-iot-hub-template \
  --resource-group my-resource-group \
  --template-file "my\path\to\template.json"

Azure Cloud Shell üzembe helyezése

Mivel az Azure Cloud Shell webböngészőben fut, az üzembe helyezési parancs futtatása előtt feltöltheti a sablonfájlt. A feltöltött fájlhoz csak a sablonfájl nevét kell használnia template-file (a teljes fájl elérési útja helyett).

Képernyőkép a fájl feltöltéséhez az Azure Cloud Shellben található gomb helyéről.

az deployment group create \
  --name my-iot-hub-template \
  --resource-group my-resource-group \
  --template-file "template.json"

Feljegyzés

Ha az üzembe helyezés sikertelen, a -verbose kapcsolóval információkat kaphat a létrehozott erőforrásokról. A kapcsolóval -debug további információt kaphat a hibakeresésről.

Az üzembe helyezés megerősítése

Annak ellenőrzéséhez, hogy a sablon sikeresen üzembe lett-e helyezve az Azure-ban, lépjen az erőforráscsoport erőforrására az Azure Portalon. A Beállítások csoport erőforrásmenüjében válassza a Központi telepítések lehetőséget a sablon megtekintéséhez az üzemelő példányok listájában.

Képernyőkép egy erőforrás üzembe helyezésének listájáról az Azure Portalon, kiemelt tesztsablonnal.

Ha meg szeretné tekinteni az új útvonalat az Azure Portalon, nyissa meg az IoT Hub-erőforrást. Az Üzenet útválasztása panel Útvonalak lapján ellenőrizze, hogy az útvonal szerepel-e a listában.

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.