Vytváření a odstraňování tras a koncových bodů pomocí Azure PowerShell

  • Článek

V tomto článku se dozvíte, jak v centru v Azure IoT Hub vytvořit trasu a koncový bod a pak odstranit trasu a koncový bod. Naučte se používat Azure PowerShell k vytváření tras a koncových bodů pro Azure Event Hubs, fronty a témata Azure Service Bus a Azure Storage.

Další informace o tom, jak směrování funguje v IoT Hub, najdete v tématu Použití IoT Hub směrování zpráv k odesílání zpráv zařízení-cloud do různých koncových bodů. Informace o nastavení trasy, která odesílá zprávy do úložiště, a následné testování na simulovaném zařízení najdete v tématu Kurz: Odesílání dat zařízení do služby Azure Storage pomocí IoT Hub směrování zpráv.

Požadavky

Postupy popsané v článku používají následující zdroje informací:

  • Azure PowerShell
  • Služba IoT Hub
  • Služba koncového bodu v Azure

Azure PowerShell

Tento článek používá Azure PowerShell při práci s IoT Hub a dalšími službami Azure. Pokud chcete Azure PowerShell používat místně, nainstalujte do počítače modul Azure PowerShell. Pokud chcete Azure PowerShell používat ve webovém prohlížeči, povolte Azure Cloud Shell.

Centrum IoT

K vytvoření trasy centra IoT potřebujete centrum IoT, které jste vytvořili pomocí Azure IoT Hub. Zprávy a protokoly událostí zařízení pocházejí z vašeho centra IoT.

Při vytváření trasy centra IoT Hub nezapomeňte použít následující prostředek:

Služba koncového bodu

Pokud chcete vytvořit trasu centra IoT, potřebujete alespoň jednu další službu Azure, která se použije jako koncový bod trasy. Koncový bod přijímá zprávy zařízení a protokoly událostí. Můžete zvolit, kterou službu Azure použijete pro koncový bod pro připojení k vaší trase centra IoT: Event Hubs, fronty nebo témata služby Service Bus nebo Azure Storage.

Ujistěte se, že máte jeden z následujících prostředků, které můžete použít při vytváření koncového bodu trasy služby IoT Hub:

Vytváření prostředků a koncových bodů

V IoT Hub můžete vytvořit trasu pro odesílání zpráv nebo zachytávání událostí. Každá trasa má zdroj dat a koncový bod. Zdrojem dat jsou zprávy nebo protokoly událostí. Koncový bod je místo, kde končí zprávy nebo protokoly událostí. Umístění pro zdroj dat a koncový bod zvolíte při vytváření nové trasy ve službě IoT Hub. Pak pomocí dotazů směrování vyfiltrujete zprávy nebo události před jejich přechodem do koncového bodu.

Jako koncový bod pro trasu služby IoT Hub můžete použít centrum událostí, frontu nebo téma služby Service Bus nebo účet úložiště. Služba, kterou použijete k vytvoření koncového bodu, musí nejprve existovat ve vašem účtu Azure.

Poznámka

Pokud používáte místní verzi Azure PowerShell, přihlaste se k Azure PowerShell, než začnete.

Příkazy v následujících postupech používají tyto odkazy:

Vytvoření centra událostí

Vytvoření nového prostředku služby Event Hubs s autorizačním pravidlem:

  1. Vytvořte nový obor názvů služby Event Hubs. Pro NamespaceNamepoužijte jedinečnou hodnotu.

    New-AzEventHubNamespace -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Location MyLocation

  2. Vytvořte novou entitu Event Hubs. Pro Namepoužijte jedinečnou hodnotu. Pro NamespaceNamepoužijte název oboru názvů, který jste vytvořili v předchozím kroku.

    New-AzEventHub -Name MyEventHub -NamespaceName MyNamespace -ResourceGroupName MyResourceGroup

  3. Vytvořte nové autorizační pravidlo. Pro Namepoužijte název entity pro EventHubName. Jako název autorizačního pravidla použijte jedinečnou hodnotu.

    New-AzEventHubAuthorizationRule -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule -Rights @('Manage', 'Send', 'Listen')

    Další informace o přístupu najdete v tématu Autorizace přístupu k Azure Event Hubs.

Vytvoření koncového bodu služby Event Hubs

  1. Získejte primární připojovací řetězec z centra událostí. Zkopírujte připojovací řetězec a použijte ho později.

    Get-AzEventHubKey -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -EventHubName MyEventHub -Name MyAuthRule

  2. Vytvořte nový koncový bod centra IoT pro službu Event Hubs. Použijte primární připojovací řetězec z předchozího kroku. Hodnota pro EndpointType musí být EventHub. Pro všechny ostatní parametry použijte hodnoty pro váš scénář.

    Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType EventHub -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "Endpoint=<my connection string>"

    Všechny možnosti koncového bodu směrování najdete v tématu Add-AzIotHubRoutingEndpoint.

Vytvoření trasy IoT Hub

S novým koncovým bodem ve službě IoT Hub můžete vytvořit novou trasu.

Výchozí záložní trasa v IoT Hub shromažďuje zprávy z DeviceMessages. Zvolte pro vlastní trasu jinou možnost, například DeviceConnectionStateEvents. Další informace o možnostech zdroje najdete v tématu Add-AzIotHubRoute. Parametr Enabled je přepínač, takže s parametrem nemusíte používat hodnotu.

Add-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -Source DeviceLifecycleEvents -EndpointName MyEndpoint -Enabled

PowerShell zobrazí potvrzení, které vypadá podobně jako v tomto příkladu:

RouteName     : MyIotHub 
DataSource    : DeviceLifecycleEvents
EndpointNames : MyEndpoint
Condition     : true
IsEnabled     : True

Aktualizace trasy IoT Hub

Pokud chcete změnit existující trasu, použijte následující příkaz. Zkuste například změnit název trasy pomocí příkazu .

Set-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute

Pomocí příkazu Get-AzIotHubRoute potvrďte změnu ve vaší trase:

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

Odstranění koncového bodu

Odstranění koncového bodu:

Remove-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -PassThru

Odstranění trasy IoT Hub

Odstranění trasy IoT Hub:

Remove-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub -RouteName MyRoute -PassThru

Tip

Odstraněním trasy se neodstraní žádné koncové body ve vašem účtu Azure. Koncový bod musíte odstranit odděleně od odstranění trasy.

Další kroky

V tomto článku s postupem jste zjistili, jak vytvořit trasu a koncový bod pro službu Event Hubs, fronty a témata služby Service Bus a Azure Storage.

Další informace o směrování zpráv najdete v tématu Kurz: Odesílání dat zařízení do služby Azure Storage pomocí IoT Hub směrování zpráv. V tomto kurzu vytvoříte trasu úložiště a otestujete ji pomocí zařízení ve službě IoT Hub.