Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La CLI de Azure se usa para crear y administrar recursos de Azure desde la línea de comandos o en scripts. En esta guía de inicio rápido se detalla el uso de la CLI de Azure para crear un centro de IoT Hub y una instancia de Device Provisioning Service de IoT Hub y vincular los dos servicios juntos.
Si no tiene una cuenta de Azure, cree una cuenta gratuita antes de comenzar.
Importante
Tanto IoT Hub como el servicio de aprovisionamiento que cree en esta guía de inicio rápido se podrán detectar públicamente como puntos de conexión DNS. Asegúrese de evitar cualquier información confidencial si decide cambiar los nombres usados para estos recursos.
Prerrequisitos
Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.
Si prefieres ejecutar comandos de referencia CLI localmente, instala la CLI de Azure. Si estás utilizando Windows o macOS, considera ejecutar Azure CLI en un contenedor Docker. Para obtener más información, consulte Cómo ejecutar el Azure CLI en un contenedor de Docker.
Si estás utilizando una instalación local, inicia sesión en Azure CLI utilizando el comando az login. Para finalizar el proceso de autenticación, siga los pasos que se muestran en el terminal. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.
Cuando se le solicite, instale la extensión de la CLI de Azure en el primer uso. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.
Ejecute az version para ver la versión y las bibliotecas dependientes que están instaladas. Para actualizar a la versión más reciente, ejecute az upgrade.
Creación de un grupo de recursos
Para crear un grupo de recursos, use el comando az group create. Un grupo de recursos de Azure es un contenedor lógico en el que se implementan y se administran los recursos de Azure.
En el ejemplo siguiente se crea un grupo de recursos denominado my-sample-resource-group en la ubicación westus .
az group create --name my-sample-resource-group --___location westus
Sugerencia
El ejemplo crea el grupo de recursos en la ubicación de oeste de EE. UU. Para ver una lista de ubicaciones disponibles, ejecute el comando az account list-locations -o table.
Creación de un centro de IoT
Cree un centro de IoT con el comando az iot hub create .
En el ejemplo siguiente se crea un centro de IoT denominado my-sample-hub en la ubicación westus . Un nombre de centro de IoT debe ser único globalmente en Azure, por lo que debe agregar un prefijo único o sufijo al nombre de ejemplo o elegir un nombre nuevo por completo. Asegúrese de que el nombre siga las convenciones de nomenclatura adecuadas para un centro de IoT: debe tener entre 3 y 50 caracteres de longitud y solo puede contener caracteres alfanuméricos en mayúsculas o minúsculas, o guiones ("-").
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --___location westus
Creación de una instancia de Device Provisioning Service
Cree una instancia de Device Provisioning Service con el comando az iot dps create .
En el ejemplo siguiente se crea una instancia de Device Provisioning Service denominada my-sample-dps en la ubicación westus . También deberá elegir un nombre único global para su propia instancia. Asegúrese de que sigue las convenciones de nomenclatura adecuadas para un servicio IoT Hub Device Provisioning: debe tener una longitud de 3 a 64 caracteres y solo puede contener caracteres alfanuméricos en mayúsculas, minúsculas o guiones ("-").
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --___location westus
Sugerencia
En el ejemplo se crea el servicio de aprovisionamiento en la ubicación Oeste de EE. UU. Para ver una lista de ubicaciones disponibles, ejecute el comando az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table o vaya a la página Estado de Azure y busque "Device Provisioning Service". En los comandos, las ubicaciones se pueden especificar en formato de una palabra o de varias; por ejemplo, westus, West US, WEST US, etc. El valor no distingue mayúsculas de minúsculas. Si usa formato de varias palabras para especificar la ubicación, incluya el valor entre comillas; por ejemplo, --___location "West US".
Para lograr resistencia y confiabilidad, recomendamos la implementación en una de las regiones que admiten las Availability Zones.
Obtener la cadena de conexión para el hub de IoT
Necesita la cadena de conexión de su IoT hub para vincularla con el Device Provisioning Service. Use el comando az iot hub connection-string show para obtener la cadena de conexión y use su salida para establecer una variable que se usa más adelante, al vincular los dos recursos.
En el siguiente ejemplo, se establece la variable hubConnectionString en el valor de la cadena de conexión para la clave principal de la directiva iothubowner del centro (el parámetro --policy-name se puede usar para especificar una directiva diferente). Reemplaza my-sample-hub por el nombre único del hub IoT que elegiste anteriormente. El comando usa las opciones de consulta y salida de la CLI de Azure para extraer la cadena de conexión de la salida del comando.
hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)
Puede usar el echo comando para ver la cadena de conexión.
echo $hubConnectionString
Nota:
Estos dos comandos son válidos para un host que se ejecuta en Bash.
Si usa un shell de Windows o CMD local o un host de PowerShell, modifique los comandos para usar la sintaxis correcta para ese entorno.
Si usa Azure Cloud Shell, compruebe que la lista desplegable del entorno en el lado izquierdo de la ventana del shell indica Bash.
Vinculación del centro de IoT y del servicio de aprovisionamiento
Vincule el centro de IoT y el servicio de aprovisionamiento con el comando az iot dps linked-hub create .
En el ejemplo siguiente se vincula un centro de IoT denominado my-sample-hub en la ubicación westus y un servicio Device Provisioning denominado my-sample-dps. Cambie estos nombres por los nombres únicos de IoT Hub y Device Provisioning Service que eligió antes. El comando usa la cadena de conexión del centro de IoT que se almacenó en la variable hubConnectionString en el paso anterior.
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --___location westus
El comando puede tardar varios minutos en completarse.
Comprobación del servicio de aprovisionamiento
Obtenga los detalles del servicio de aprovisionamiento con el comando az iot dps show .
En el ejemplo siguiente se obtienen los detalles de un servicio de aprovisionamiento denominado my-sample-dps. Sustituya este nombre por el de su propio Servicio de Aprovisionamiento de Dispositivos.
az iot dps show --name my-sample-dps
El centro de IoT vinculado se muestra en la colección properties.iotHubs .
Limpieza de recursos
Otros inicios rápidos de esta colección se basan en este inicio rápido. Si tiene previsto seguir trabajando con los siguientes inicios rápidos o tutoriales, no elimine los recursos creados en este inicio rápido. Si no tiene previsto continuar, puede usar los siguientes comandos para eliminar el servicio de aprovisionamiento, el centro de IoT o el grupo de recursos y todos sus recursos. Reemplace los nombres de los recursos incluidos en los siguientes comandos por los nombres de sus propios recursos.
Para eliminar el servicio de aprovisionamiento, ejecute el comando az iot dps delete :
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
Para eliminar el centro de IoT, ejecute el comando az iot hub delete :
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Para eliminar un grupo de recursos y todos sus recursos, ejecute el comando az group delete :
az group delete --name my-sample-resource-group
Pasos siguientes
En este inicio rápido, ha implementado un centro de IoT y una instancia de Device Provisioning Service, y ha vinculado los dos recursos. Para saber cómo usar esta configuración para aprovisionar un dispositivo, vaya al inicio rápido en el que se explica cómo crear un dispositivo.