Criar e excluir rotas e pontos de extremidade usando o Azure PowerShell

Este artigo mostra como criar uma rota e um ponto de extremidade em seu hub no Hub IoT do Azure e, em seguida, excluir sua rota e ponto de extremidade. Saiba como usar o Azure PowerShell para criar rotas e pontos de extremidade para Hubs de Eventos do Azure, filas e tópicos do Barramento de Serviço do Azure e Armazenamento do Azure.

Para saber mais sobre como o roteamento funciona no Hub IoT, consulte Usar o roteamento de mensagens do Hub IoT para enviar mensagens do dispositivo para a nuvem para diferentes pontos de extremidade. Para percorrer a configuração de uma rota que envia mensagens para o armazenamento e, em seguida, testar em um dispositivo simulado, consulte Tutorial: Enviar dados do dispositivo para o Armazenamento do Azure usando o roteamento de mensagens do Hub IoT.

Pré-requisitos

Os procedimentos descritos no artigo usam os seguintes recursos:

• Azure PowerShell
• Um hub IoT
• Um serviço de ponto de extremidade no Azure

Azure PowerShell

Este artigo usa o Azure PowerShell para trabalhar com o Hub IoT e outros serviços do Azure. Para usar o Azure PowerShell localmente, instale o módulo do Azure PowerShell em seu computador. Como alternativa, para usar o Azure PowerShell em um navegador da Web, habilite o Azure Cloud Shell.

Hub IoT

Para criar uma rota de hub IoT, você precisa de um hub IoT criado usando o Hub IoT do Azure. As mensagens do dispositivo e os logs de eventos são originários do seu hub IoT.

Certifique-se de ter o seguinte recurso de hub para usar ao criar sua rota de hub IoT:

• Um hub IoT do Azure. Se você não tiver um hub IoT, poderá usar o cmdlet New-AzIoTHub para criar um ou seguir as etapas em Criar um hub IoT.

Serviço de ponto final

Para criar uma rota de hub IoT, você precisa de pelo menos um outro serviço do Azure para usar como um ponto de extremidade para a rota. O ponto de extremidade recebe mensagens do dispositivo e logs de eventos. Você pode escolher qual serviço do Azure você usa para um ponto de extremidade para se conectar à sua rota de hub IoT: Hubs de Eventos, filas ou tópicos do Barramento de Serviço ou Armazenamento do Azure.

Certifique-se de ter um dos seguintes recursos para usar ao criar um ponto de extremidade sua rota do hub IoT:

• Um recurso de Hubs de Eventos (com contêiner). Se você precisar criar um novo recurso de Hubs de Eventos, consulte Guia de início rápido: criar um hub de eventos usando o Azure PowerShell.

• Um recurso de fila do Service Bus. Se você precisar criar uma nova fila do Service Bus, consulte Usar o Azure PowerShell para criar um namespace e uma fila do Service Bus.

• Um recurso de tópico do Service Bus. Se você precisar criar um novo tópico do Service Bus, consulte a referência New-AzServiceBusTopic e a documentação de mensagens do Barramento de Serviço do Azure.

• Um recurso de Armazenamento do Azure. Se você precisar criar uma nova conta de armazenamento no Azure, consulte Criar uma conta de armazenamento.

Criar recursos e pontos de extremidade

No Hub IoT, você pode criar uma rota para enviar mensagens ou capturar eventos. Cada rota tem uma fonte de dados e um ponto de extremidade. A fonte de dados é onde as mensagens ou logs de eventos se originam. O ponto de extremidade é onde as mensagens ou logs de eventos terminam. Você escolhe locais para a fonte de dados e o ponto de extremidade quando cria uma nova rota em seu hub IoT. Em seguida, use consultas de roteamento para filtrar mensagens ou eventos antes que eles vão para o ponto de extremidade.

Você pode usar um hub de eventos, uma fila ou tópico do Service Bus ou uma conta de armazenamento para ser o ponto de extremidade para sua rota de hub IoT. O serviço que você usa para criar seu ponto de extremidade deve primeiro existir em sua conta do Azure.

Nota

Se você usar uma versão local do Azure PowerShell, entre no Azure PowerShell antes de começar.

Hubs de Eventos

Os comandos nos procedimentos a seguir usam essas referências:

• Az.IotHub
• Az.EventHub

Criar um hub de eventos

Para criar um novo recurso de Hubs de Eventos que tenha uma regra de autorização:

1. Crie um novo namespace de Hubs de Eventos. Para NamespaceName, use um valor exclusivo.

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

2. Crie sua nova entidade de Hubs de Eventos. Para Name, use um valor exclusivo. Para NamespaceName, use o nome do namespace criado na etapa anterior.

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

3. Crie uma nova regra de autorização. Para Name, use o nome da sua entidade para EventHubName. Para o nome da regra de autorização, use um valor exclusivo.

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

   Para obter mais informações sobre acesso, consulte Autorizar acesso aos Hubs de Eventos do Azure.

Criar um ponto de extremidade de Hubs de Eventos

1. Obtenha a cadeia de conexão principal do seu hub de eventos. Copie a cadeia de conexão para usar mais tarde.

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

2. Crie um novo ponto de extremidade do hub IoT para Hubs de Eventos. Use sua cadeia de conexão principal da etapa anterior. O valor para EndpointType deve ser EventHub. Para todos os outros parâmetros, use os valores para o seu cenário.

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

   Para ver todas as opções de ponto de extremidade de roteamento, consulte Add-AzIotHubRoutingEndpoint.

Fila do Service Bus

Os comandos nos procedimentos a seguir usam essas referências:

• Az.IotHub
• Az.ServiceBus

Criar um namespace e uma fila do Service Bus

Para criar um novo recurso de fila do Service Bus :

1. Crie um novo namespace do Service Bus. Para Name, use um valor exclusivo.

   New-AzServiceBusNamespace -ResourceGroupName MyResourceGroup -Name MyNamespace -Location MyRegion
   

2. Crie uma nova fila do Service Bus. Para NamespaceName, use o nome do namespace criado na etapa anterior. Para o nome da fila, use um valor exclusivo.

   New-AzServiceBusQueue -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Name MyQueue
   

Criar um ponto de extremidade de fila do Service Bus

Para criar um novo ponto de extremidade de fila do Service Bus:

1. Recupere a cadeia de conexão primária do seu namespace do Service Bus. Copie a cadeia de conexão para usar mais tarde.

   Get-AzServiceBusKey -ResourceGroupName MyResourceGroup -Namespace MyNamespace -Name RootManageSharedAccessKey
   

2. Crie um novo ponto de extremidade do hub IoT para sua fila do Service Bus. Use sua cadeia de conexão principal da etapa anterior com ;EntityPath=MyServiceBusQueue adicionado ao final. O valor para EndpointType deve ser ServiceBusQueue. Para todos os outros parâmetros, use os valores para o seu cenário. Para EndpointName, use um valor exclusivo.

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

   Para obter uma lista de todas as opções de ponto de extremidade de roteamento, consulte Add-AzIotHubRoutingEndpoint.

Tópico do Service Bus

Os comandos nos procedimentos a seguir usam essas referências:

• Az.IotHub
• Az.ServiceBus

Com os tópicos do Service Bus , os usuários podem se inscrever em um ou mais tópicos. Para criar um tópico, você também cria um namespace e uma assinatura do Service Bus.

Criar um namespace, tópico e assinatura do Service Bus

1. Crie um novo namespace do Service Bus. Para Name seu namespace, use um valor exclusivo.

   New-AzServiceBusNamespace -ResourceGroupName MyResourceGroup -Name MyNamespace -Location MyRegion
   

2. Crie um novo tópico do Service Bus. Para o nome do tópico, use um valor exclusivo.

   New-AzServiceBusTopic -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -Name MyTopic
   

3. Crie uma nova subscrição para o seu tópico. Para TopicName, use o nome do tópico criado na etapa anterior. Para o nome da sua assinatura, use um valor exclusivo.

   New-AzServiceBusSubscription -ResourceGroupName MyResourceGroup -NamespaceName MyNamespace -TopicName MyTopic -Name MySubscription
   

Criar um ponto de extremidade de tópico do Service Bus

1. Recupere a cadeia de conexão primária do seu namespace do Service Bus. Copie a cadeia de conexão para usar mais tarde.

   Get-AzServiceBusKey -ResourceGroupName MyResourceGroup -Namespace MyNamespace -Name RootManageSharedAccessKey
   

2. Crie um novo ponto de extremidade do hub IoT para seu tópico do Service Bus. Use sua cadeia de conexão principal da etapa anterior com ;EntityPath=MyServiceBusTopic adicionado ao final. O valor para EndpointType deve ser ServiceBusTopic. Para todos os outros parâmetros, use os valores para o seu cenário. Para EndpointName, use um valor exclusivo.

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

   Para obter uma lista de todas as opções de ponto de extremidade de roteamento, consulte Add-AzIotHubRoutingEndpoint.

Armazenamento do Azure

Os comandos nos procedimentos a seguir usam essas referências:

• Az.IotHub
• Az.Storage

Para criar um ponto de extremidade e uma rota do Armazenamento do Azure, você precisa de uma conta e um contêiner de Armazenamento.

Criar uma conta e um contêiner de Armazenamento do Azure

1. Crie uma nova conta de Armazenamento do Azure. O valor de para sua conta de Name armazenamento pode conter apenas letras minúsculas e números. Para SkuName obter opções, consulte SkuName.

   New-AzStorageAccount -ResourceGroupName MyResourceGroup -Name mystorageaccount -Location westus -SkuName Standard_GRS
   

2. Crie um novo contêiner em sua conta de armazenamento. Você precisa criar um contexto para sua conta de armazenamento em uma variável e, em seguida, adicionar a variável ao Context parâmetro. Para saber mais sobre suas opções ao criar um contêiner, consulte Gerenciar contêineres de blob usando o PowerShell. Para Name, use um valor exclusivo para o nome do seu contêiner.

   $ctx = New-AzStorageContext -StorageAccountName mystorageaccount -UseConnectedAccount `
   New-AzStorageContainer -Name ContainerName -Context $ctx
   

Criar um ponto de extremidade do Armazenamento do Azure

Para criar um ponto de extremidade para o Armazenamento do Azure, você precisa de sua chave de acesso para construir uma cadeia de conexão. A cadeia de conexão faz parte do comando Hub IoT para criar um ponto de extremidade.

1. Recupere a chave de acesso da sua conta de armazenamento e copie-a.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. Construa uma cadeia de conexão primária para sua conta de armazenamento com base no modelo a seguir. Substitua mystorageaccount (em dois locais) pelo nome da sua conta de armazenamento. Substitua mykey pela chave da etapa anterior.

   "DefaultEndpointsProtocol=https;BlobEndpoint=https://mystorageaccount.blob.core.windows.net;AccountName=mystorageaccount;AccountKey=mykey"
   

   Essa cadeia de conexão é necessária na etapa para criar o ponto de extremidade.

3. Crie seu ponto de extremidade do Armazenamento do Azure com a cadeia de conexão que você construiu. EndpointType deve ter o valor azurestorage. Para todos os outros parâmetros, use os valores para o seu cenário. Para EndpointName, use um valor exclusivo.

   Add-AzIotHubRoutingEndpoint -ResourceGroupName MyResourceGroup -Name MyIotHub -EndpointName MyEndpoint -EndpointType azurestorage -EndpointResourceGroup MyResourceGroup -EndpointSubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ConnectionString "my connection string"
   

4. Quando for solicitado o nome do contêiner, digite o nome do contêiner e selecione Enter para criar o ponto de extremidade.

Criar uma rota do Hub IoT

Com seu novo ponto de extremidade em seu hub IoT, você pode criar uma nova rota.

A rota de fallback padrão no Hub IoT coleta mensagens do DeviceMessages. Escolha uma opção diferente para sua rota personalizada, como DeviceConnectionStateEvents. Para obter mais informações sobre opções de origem, consulte Add-AzIotHubRoute. O Enabled parâmetro é uma opção, portanto, você não precisa usar um valor com o parâmetro.

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

O PowerShell exibe uma confirmação semelhante a este exemplo:

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

Atualizar uma rota do Hub IoT

Para fazer alterações em uma rota existente, use o comando a seguir. Por exemplo, tente alterar o nome da sua rota usando o comando.

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

Use o Get-AzIotHubRoute comando para confirmar a alteração na sua rota:

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

Excluir um ponto de extremidade

Para excluir um ponto de extremidade:

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

Excluir uma rota do Hub IoT

Para excluir uma rota do Hub IoT:

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

Gorjeta

A exclusão de uma rota não exclui nenhum ponto de extremidade em sua conta do Azure. Você deve excluir um ponto de extremidade separadamente da exclusão de uma rota.

Próximos passos

Neste artigo de instruções, você aprendeu como criar uma rota e um ponto de extremidade para Hubs de Eventos, filas e tópicos do Barramento de Serviço e Armazenamento do Azure.

Para saber mais sobre o roteamento de mensagens, consulte Tutorial: Enviar dados de dispositivo para o Armazenamento do Azure usando o roteamento de mensagens do Hub IoT. No tutorial, você cria uma rota de armazenamento e a testa com um dispositivo em seu hub IoT.