Creación y eliminación de rutas y puntos de conexión mediante Azure PowerShell

En este artículo se muestra primero cómo crear rutas y puntos de conexión en cualquier centro desde Azure IoT Hub y, luego, cómo eliminarlos. Aprenda a usar Azure PowerShell para crear rutas y puntos de conexión para Azure Event Hubs, las colas y los temas de Azure Service Bus y Azure Storage.

Para más información sobre cómo funciona el enrutamiento en IoT Hub, consulte Uso del enrutamiento de mensajes de IoT Hub para enviar mensajes del dispositivo a la nube a distintos puntos de conexión. Para obtener información sobre la configuración de una ruta que envíe mensajes al almacenamiento y la posterior realización de pruebas en un dispositivo simulado, consulte Tutorial: Envío de datos de dispositivo a Azure Storage mediante el enrutamiento de mensajes de IoT Hub.

Requisitos previos

Los procedimientos que se describen en el artículo usan los siguientes recursos:

• Azure PowerShell
• Una instancia de IoT Hub
• Un servicio de punto de conexión en Azure

Azure PowerShell

En este artículo se usa la interfaz de Azure PowerShell para trabajar con IoT Hub y otros servicios de Azure. Para usar Azure PowerShell localmente instale el módulo de Azure PowerShell en el equipo. Como alternativa, para usar Azure PowerShell en un explorador web, habilite Azure Cloud Shell.

centro de IoT

Para crear una ruta de un centro de IoT, se necesita el centro de IoT que se creó mediante Azure IoT Hub. Tanto los mensajes como los registros de eventos del dispositivo parten del centro de IoT.

Asegúrese de tener el siguiente recurso de centro para que pueda usarlo al crear la ruta del centro de IoT:

• Un centro de IoT en la suscripción de Azure. Si aún no tiene un centro, puede seguir los pasos necesarios para crear una instancia de IoT Hub mediante el cmdlet de PowerShell New-AzlotHub.

Servicio de punto de conexión

Para crear una ruta de un centro de IoT, se necesita al menos otro servicio de Azure, con el fin de usarlo como punto de conexión a la ruta. El punto de conexión recibe tanto los mensajes como los registros de eventos del dispositivo. Puede elegir qué servicio de Azure usa para que cada punto de conexión se conecte a la ruta del centro de IoT: Event Hubs, colas o temas de Service Bus o Azure Storage.

Asegúrese de tener uno de los siguientes recursos para usarlo al crear un punto de conexión en la ruta del centro de IoT:

• Un recurso de Event Hubs (con contenedor). Si necesita crear un recurso de Event Hubs, consulte Inicio rápido: Creación de un centro de eventos mediante Azure PowerShell.

• Un recurso de cola de Service Bus. Si necesita crear una nueva cola de Service Bus, consulte Uso de Azure PowerShell para crear un espacio de nombres y una cola de Service Bus.

• Un recurso de tema de Service Bus. Si necesita crear un nuevo tema de Service Bus, consulte la referencia New-AzServiceBusTopic y la documentación de la mensajería de Azure Service Bus.

• Un recurso de Azure Storage. Si necesita crear un cuenta de almacenamiento en Azure, consulte Creación de una cuenta de almacenamiento.

Creación de recursos y puntos de conexión

En IoT Hub, puede crear una ruta para enviar mensajes o capturar eventos. Cada ruta tiene un origen de datos y un punto de conexión. El origen de datos es el lugar del que parten los mensajes o los registros de eventos. El punto de conexión es el lugar en que terminan los mensajes o los registros de eventos. Cuando se crea una ruta en el centro de IoT, se eligen las ubicaciones del origen de datos y del punto de conexión. Luego, se usan consultas de enrutamiento para filtrar los mensajes o eventos antes de que van al punto de conexión.

Puede usar un centro de eventos, una cola o un tema de Service Bus o una cuenta de Azure Storage como punto de conexión de la ruta del centro de IoT. El servicio que use para crear el punto de conexión debe existir en la cuenta de Azure.

Nota:

Si usa una versión local de Azure PowerShell, inicie sesión en Azure PowerShell antes de comenzar.

Event Hubs

Los comandos de los siguientes procedimientos usan estas referencias:

• Az.IotHub
• Az.EventHub

Creación de un centro de eventos

Para crear un recurso de Event Hubs que tenga una regla de autorización:

1. Creación de un nuevo espacio de nombres de Event Hubs En NamespaceName, use un valor único.

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

2. Cree la entidad de Event Hubs. En Name, use un valor único. En NamespaceName, use el nombre del espacio de nombres que creó en el paso anterior.

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

3. Cree una nueva regla de autorización. En Name, use el nombre de la entidad en EventHubName. Para el nombre de la regla de autorización, use un valor único.

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

   Para más información sobre el acceso, consulte Autorización del acceso a Azure Event Hubs.

Creación de un punto de conexión de Event Hubs

1. Obtenga la cadena de conexión principal de su centro de eventos. Copie la cadena de conexión para usarla más adelante.

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

2. Cree un nuevo punto de conexión de IoT Hub en Event Hubs. Use la cadena de conexión principal del paso anterior. El valor de EndpointType debe ser EventHub. Para todos los demás parámetros, use los valores de su escenario.

   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 las opciones de punto de conexión de enrutamiento, consulte Add-AzIotHubRoutingEndpoint.

Cola de Service Bus

Los comandos de los siguientes procedimientos usan estas referencias:

• Az.IotHub
• Az.ServiceBus

Creación de un espacio de nombres de Service Bus y una cola

Para crear un recurso de cola de Service Bus:

1. Creación de un espacio de nombres de Service Bus. En Name, use un valor único.

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

2. Cree una cola de Service Bus. En NamespaceName, use el nombre del espacio de nombres que creó en el paso anterior. Para el nombre de la cola, use un valor único.

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

Creación de un punto de conexión de cola de Service Bus

Para crear un punto de conexión de cola de Service Bus:

1. Recupere la cadena de conexión principal del espacio de nombres de Service Bus. Copie la cadena de conexión para usarla más adelante.

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

2. Cree un nuevo punto de conexión de IoT Hub en la cola de Service Bus. Use la cadena de conexión principal del paso anterior, pero agregue ;EntityPath=MyServiceBusQueue al final. El valor de EndpointType debe ser ServiceBusQueue. Para todos los demás parámetros, use los valores de su escenario. En EndpointName, use un valor único.

   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"
   

   Si desea una lista de todas las opciones de punto de conexión de enrutamiento, consulte Add-AzIotHubRoutingEndpoint.

Tema de Service Bus

Los comandos de los siguientes procedimientos usan estas referencias:

• Az.IotHub
• Az.ServiceBus

Con los temas de Service Bus, los usuarios pueden suscribirse a uno o varios temas. Para crear un tema, también debe crear un espacio de nombres y una suscripción de Service Bus.

Creación de un espacio de nombres, un tema y una suscripción de Service Bus

1. Creación de un espacio de nombres de Service Bus. En Name, en el espacio de nombres, use un valor único.

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

2. Cree un tema de Service Bus. En el nombre del tema, use un valor único.

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

3. Cree una nueva suscripción al tema. En TopicName, use el nombre del tema que creó en el paso anterior. En el nombre de la suscripción, use un valor único.

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

Creación de un punto de conexión de Service Bus

1. Recupere la cadena de conexión principal del espacio de nombres de Service Bus. Copie la cadena de conexión para usarla más adelante.

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

2. Cree un nuevo punto de conexión de IoT Hub al el tema de Service Bus. Use la cadena de conexión principal del paso anterior, pero agregue ;EntityPath=MyServiceBusTopic al final. El valor de EndpointType debe ser ServiceBusTopic. Para todos los demás parámetros, use los valores de su escenario. En EndpointName, use un valor único.

   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"
   

   Si desea una lista de todas las opciones de punto de conexión de enrutamiento, consulte Add-AzIotHubRoutingEndpoint.

Almacenamiento de Azure

Los comandos de los siguientes procedimientos usan estas referencias:

• Az.IotHub
• Az.Storage

Para crear un punto de conexión y una ruta de Azure Storage, necesita un contenedor y una cuenta de Storage.

Creación de una cuenta y un contenedor de Azure Storage

1. Cree una nueva cuenta de Azure Storage. El valor de Name para la cuenta de almacenamiento solo puede contener letras minúsculas y números. Para ver las opciones de SkuName, consulte SkuName.

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

2. Cree un nuevo contenedor en su cuenta de almacenamiento. Debe crear un contexto para la cuenta de almacenamiento en una variable y, luego, agregar la variable al parámetro Context. Para más información sobre las opciones disponibles al crear un contenedor, consulte Administración de contenedores de blobs mediante PowerShell. En Name, use un valor único para el nombre del contenedor.

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

Creación de un punto de conexión de Azure Storage

Para crear un punto de conexión en Azure Storage, necesita la clave de acceso para construir una cadena de conexión. La cadena de conexión forma parte del comando de IoT Hub para crear un punto de conexión.

1. Recupere la clave de acceso de la cuenta de almacenamiento y cópiela.

   Get-AzStorageAccountKey -ResourceGroupName MyResourceGroup -Name mystorageaccount
   

2. Construya una cadena de conexión principal para la cuenta de almacenamiento utilizando la siguiente plantilla. Reemplace mystorageaccount (en dos lugares) por el nombre de la cuenta de almacenamiento. Reemplace mykey por la clave del paso anterior.

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

   Esta cadena de conexión es necesaria en el paso para crear el punto de conexión.

3. Cree el punto de conexión de Azure Storage con la cadena de conexión que ha construido. EndpointType debe tener el valor azurestorage. Para todos los demás parámetros, use los valores de su escenario. En EndpointName, use un valor único.

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

4. Cuando se le pida el nombre del contenedor, escríbalo y, después, seleccione Entrar para crear el punto de conexión.

Creación de una ruta de IoT Hub

Con el nuevo punto de conexión del IoT Hub, puede crear una ruta.

La ruta de reserva predeterminada de IoT Hub recopila mensajes de DeviceMessages. Elija otra opción para la ruta personalizada, como DeviceConnectionStateEvents. Para más información acerca de las opciones de origen, consulte Add-AzIotHubRoute. El parámetro Enabled es un modificador, por lo que no es necesario usar ningún valor con el parámetro.

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

PowerShell muestra una confirmación similar a la de este ejemplo:

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

Actualización de una ruta de IoT Hub

Para realizar cambios en una ruta existente, use el siguiente comando. Por ejemplo, pruebe a cambiar el nombre de la ruta mediante el comando.

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

Use el comando Get-AzIotHubRoute para confirmar el cambio en la ruta:

Get-AzIotHubRoute -ResourceGroupName MyResourceGroup -Name MyIotHub

Eliminar un extremo

Para eliminar un punto de conexión:

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

Eliminación de una ruta de IoT Hub

Para eliminar una ruta de IoT Hub:

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

Sugerencia

La eliminación de una ruta no elimina ningún punto de conexión de la cuenta de Azure. Los puntos de conexión se deben eliminar independientemente de la eliminación de rutas.

Pasos siguientes

En este artículo de procedimientos ha aprendido a crear una ruta y un punto de conexión para Event Hubs, colas o temas de Service Bus y Azure Storage.

Para más información sobre el enrutamiento de mensajes, consulte Tutorial: Envío de datos de dispositivo a Azure Storage mediante el enrutamiento de mensajes de IoT Hub. En este tutorial, se crea una ruta de almacenamiento y se prueba con un dispositivo de un centro de IoT.