Creación de una instancia de IoT Hub mediante la CLI de Azure
En este artículo se muestra cómo utilizar la CLI de Azure para crear una instancia de IoT Hub.
Prerrequisitos
Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.
Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.
Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.
En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.
Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.
Cuando crea una instancia de IoT Hub, debe crearla en un grupo de recursos. Use un grupo de recursos existente o ejecute el comando siguiente para crear un grupo de recursos:
az group create --name {your resource group name} --location westus
Sugerencia
El ejemplo anterior crea el grupo de recursos en la ubicación del oeste de EE. UU. Puede ejecutar el siguiente comando para ver una lista de las ubicaciones disponibles:
az account list-locations -o table
Crear un centro de IoT
Use la CLI de Azure para crear un grupo de recursos y, luego, agregue una instancia de IoT Hub.
Ejecute el comando siguiente para crear una instancia de IoT Hub en el grupo de recursos, con un nombre único global para la instancia de IoT Hub:
az iot hub create --name {your iot hub name} \
--resource-group {your resource group name} --sku S1
Importante
Como el centro de IoT se podrá detectar públicamente como un punto de conexión de DNS, asegúrese de que no incluye información de identificación personal ni información confidencial al asignarle un nombre.
El comando anterior crea un centro de IoT Hub en el plan de tarifa S1 en el que se le factura. Para obtener más información, vea el artículo sobre precios de IoT Hub.
Para más información sobre los comandos de Azure IoT Hub, consulte el artículo de referencia az iot hub
.
Actualización del centro de IoT
Puede cambiar la configuración de un centro de IoT existente después de crearlo. Estas son algunas propiedades que puede establecer para un centro de IoT:
Precios y escala: migración a un nivel diferente o establecimiento del número de unidades de IoT Hub.
IP Filter (Filtro de IP): especifique un intervalo de direcciones IP que el centro de IoT va a aceptar o rechazar.
Propiedades: una lista de propiedades que puede copiar y usar en otra parte, como el id. de recursos, el grupo de recursos, la ubicación, etc.
Para obtener una lista completa de las opciones para actualizar un centro de IoT, consulte la página de referencia de comandos az iot hub update.
Registro de un nuevo dispositivo en el centro de IoT
En esta sección, creará una identidad de dispositivo en el registro de identidades del centro de IoT. No se puede conectar un dispositivo a un centro a menos que tenga una entrada en el registro de identidades. Para más información, consulte Descripción del registro de identidades de un centro de IoT. Esta identidad del dispositivo tiene IoT Edge habilitado.
Ejecute el siguiente comando para crear una identidad de dispositivo. Use el nombre del centro de IoT y cree un nuevo nombre de id. de dispositivo en vez de {iothub_name}
y {device_id}
. Este comando crea una identidad del dispositivo con autorización predeterminada (clave privada compartida).
az iot hub device-identity create -n {iothub_name} -d {device_id} --ee
El resultado es una impresión JSON que incluye las claves y otra información.
Como alternativa, hay varias opciones para registrar un dispositivo mediante diferentes tipos de autorización. Para explorar las opciones, consulte Ejemplos en la página de referencia de az iot hub device-identity.
Eliminar un centro de IoT
Hay varios comandos para eliminar un recurso individual, por ejemplo, un centro de IoT.
Ejecute el comando siguiente para eliminar una instancia de IoT Hub:
az iot hub delete --name {your iot hub name} -\
-resource-group {your resource group name}
Pasos siguientes
Obtenga más información sobre los comandos disponibles en la extensión de IoT de Microsoft Azure para la CLI de Azure: