az iot ops
Nota:
Esta referencia forma parte de la extensión azure-iot-ops para la CLI de Azure (versión 2.53.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az iot ops . Obtenga más información sobre las extensiones.
Administración de operaciones de Azure IoT.
Azure IoT Operations es un conjunto de servicios de Kubernetes altamente alineados, pero acoplados de forma flexible que permiten agregar datos de recursos locales a un agente MQTT de nivel industrial, agregar proceso perimetral y configurar el flujo de datos bidireccional con una variedad de servicios en la nube.
De forma predeterminada, los comandos de la CLI de IoT Operations comprobarán periódicamente si hay disponible una nueva versión de extensión.
Este comportamiento se puede deshabilitar con az config set iotops.check_latest=false
.
Comandos
Nombre | Description | Tipo | Estado |
---|---|---|---|
az iot ops asset |
Administración de activos. |
Extensión | GA |
az iot ops asset create |
Cree un recurso. |
Extensión | GA |
az iot ops asset dataset |
Administrar conjuntos de datos en un recurso. |
Extensión | GA |
az iot ops asset dataset list |
Enumerar conjuntos de datos dentro de un recurso. |
Extensión | GA |
az iot ops asset dataset point |
Administrar puntos de datos en un conjunto de datos de recursos. |
Extensión | GA |
az iot ops asset dataset point add |
Agregue un punto de datos a un conjunto de datos de recursos. |
Extensión | GA |
az iot ops asset dataset point export |
Exportar puntos de datos en un conjunto de datos de recursos. |
Extensión | GA |
az iot ops asset dataset point import |
Importe puntos de datos en un conjunto de datos de recursos. |
Extensión | GA |
az iot ops asset dataset point list |
Enumeración de puntos de datos en un conjunto de datos de recursos. |
Extensión | GA |
az iot ops asset dataset point remove |
Quite un punto de datos de un conjunto de datos de recursos. |
Extensión | GA |
az iot ops asset dataset show |
Mostrar un conjunto de datos dentro de un recurso. |
Extensión | GA |
az iot ops asset delete |
Eliminar un recurso. |
Extensión | GA |
az iot ops asset endpoint |
Administrar perfiles de punto de conexión de recursos. |
Extensión | GA |
az iot ops asset endpoint create |
Cree perfiles de punto de conexión de recursos. |
Extensión | GA |
az iot ops asset endpoint create opcua |
Cree un perfil de punto de conexión de recurso con un conector OPCUA. |
Extensión | GA |
az iot ops asset endpoint delete |
Elimine un perfil de punto de conexión de recurso. |
Extensión | GA |
az iot ops asset endpoint query |
Consulte resource Graph para ver los perfiles de punto de conexión de recursos. |
Extensión | GA |
az iot ops asset endpoint show |
Mostrar un perfil de punto de conexión de recurso. |
Extensión | GA |
az iot ops asset endpoint update |
Actualice un perfil de punto de conexión de recurso. |
Extensión | GA |
az iot ops asset event |
Administrar eventos en un recurso. |
Extensión | GA |
az iot ops asset event add |
Agregue un evento a un recurso. |
Extensión | GA |
az iot ops asset event export |
Exportar eventos en un recurso. |
Extensión | GA |
az iot ops asset event import |
Importar eventos en un recurso. |
Extensión | GA |
az iot ops asset event list |
Enumerar eventos en un recurso. |
Extensión | GA |
az iot ops asset event remove |
Quite un evento en un recurso. |
Extensión | GA |
az iot ops asset query |
Consulte resource Graph para los recursos. |
Extensión | GA |
az iot ops asset show |
Mostrar un recurso. |
Extensión | GA |
az iot ops asset update |
Actualice un recurso. |
Extensión | GA |
az iot ops broker |
Administración del agente mqtt. |
Extensión | GA |
az iot ops broker authn |
Administración de la autenticación del agente. |
Extensión | GA |
az iot ops broker authn delete |
Elimine un recurso de autenticación de agente mqtt. |
Extensión | GA |
az iot ops broker authn list |
Enumere los recursos de autenticación del agente mqtt asociados a una instancia. |
Extensión | GA |
az iot ops broker authn show |
Mostrar detalles de un recurso de autenticación de agente mqtt. |
Extensión | GA |
az iot ops broker authz |
Administración de la autorización del agente. |
Extensión | GA |
az iot ops broker authz delete |
Elimine un recurso de autorización de agente mqtt. |
Extensión | GA |
az iot ops broker authz list |
Enumere los recursos de autorización del agente mqtt asociados a una instancia. |
Extensión | GA |
az iot ops broker authz show |
Muestra los detalles de un recurso de autorización de agente mqtt. |
Extensión | GA |
az iot ops broker delete |
Elimine un agente mqtt. |
Extensión | GA |
az iot ops broker list |
Enumerar agentes mqtt asociados a una instancia de . |
Extensión | GA |
az iot ops broker listener |
Administración del agente de escucha. |
Extensión | GA |
az iot ops broker listener delete |
Elimine un agente de escucha de mqtt broker. |
Extensión | GA |
az iot ops broker listener list |
Enumera los agentes de escucha de agente mqtt asociados a un agente. |
Extensión | GA |
az iot ops broker listener show |
Muestra los detalles de un agente de escucha de mqtt. |
Extensión | GA |
az iot ops broker show |
Mostrar detalles de un agente mqtt. |
Extensión | GA |
az iot ops check |
Evalúe la preparación del lado clúster y el estado en tiempo de ejecución de los servicios de operaciones de IoT implementados. |
Extensión | Vista previa |
az iot ops connector |
Administración de conectores. |
Extensión | Vista previa |
az iot ops connector opcua |
Administración del conector de OPC UA. |
Extensión | Vista previa |
az iot ops connector opcua client |
Administre el certificado de instancia de aplicación cliente de nivel empresarial para OPC UA Broker. |
Extensión | Vista previa |
az iot ops connector opcua client add |
Agregue un certificado de instancia de aplicación cliente de nivel empresarial. |
Extensión | Vista previa |
az iot ops connector opcua client remove |
Quite el certificado de instancia de aplicación cliente del Agente de OPC UA. |
Extensión | Vista previa |
az iot ops connector opcua client show |
Muestra los detalles del recurso secretsync "aio-opc-ua-broker-client-certificate". |
Extensión | Vista previa |
az iot ops connector opcua issuer |
Administrar certificados de emisor para el agente de OPC UA. |
Extensión | Vista previa |
az iot ops connector opcua issuer add |
Agregue un certificado de emisor a la lista de certificados del emisor del agente de OPC UA. |
Extensión | Vista previa |
az iot ops connector opcua issuer remove |
Quite los certificados de confianza de la lista de certificados del emisor del agente de OPC UA. |
Extensión | Vista previa |
az iot ops connector opcua issuer show |
Mostrar detalles del recurso secretsync "aio-opc-ua-broker-issuer-list". |
Extensión | Vista previa |
az iot ops connector opcua trust |
Administrar certificados de confianza para el agente de OPC UA. |
Extensión | Vista previa |
az iot ops connector opcua trust add |
Agregue un certificado de confianza a la lista de certificados de confianza de OPC UA Broker. |
Extensión | Vista previa |
az iot ops connector opcua trust remove |
Quite los certificados de confianza de la lista de certificados de confianza de OPC UA Broker. |
Extensión | Vista previa |
az iot ops connector opcua trust show |
Mostrar detalles del recurso secretsync "aio-opc-ua-broker-trust-list". |
Extensión | Vista previa |
az iot ops create |
Cree una instancia de IoT Operations. |
Extensión | GA |
az iot ops dataflow |
Administración del flujo de datos. |
Extensión | GA |
az iot ops dataflow endpoint |
Administración de puntos de conexión de flujo de datos. |
Extensión | GA |
az iot ops dataflow endpoint list |
Enumera los recursos del punto de conexión de flujo de datos asociados a una instancia. |
Extensión | GA |
az iot ops dataflow endpoint show |
Mostrar detalles de un recurso de punto de conexión de flujo de datos. |
Extensión | GA |
az iot ops dataflow list |
Enumera los flujos de datos asociados a un perfil de flujo de datos. |
Extensión | GA |
az iot ops dataflow profile |
Administración de perfiles de flujo de datos. |
Extensión | GA |
az iot ops dataflow profile list |
Enumera los perfiles de flujo de datos asociados a una instancia de . |
Extensión | GA |
az iot ops dataflow profile show |
Mostrar detalles de un perfil de flujo de datos. |
Extensión | GA |
az iot ops dataflow show |
Mostrar detalles de un flujo de datos asociado a un perfil de flujo de datos. |
Extensión | GA |
az iot ops delete |
Elimine las operaciones de IoT del clúster. |
Extensión | GA |
az iot ops identity |
Administración de identidades de instancia. |
Extensión | GA |
az iot ops identity assign |
Asigne una identidad administrada asignada por el usuario con la instancia de . |
Extensión | GA |
az iot ops identity remove |
Quite una identidad administrada asignada por el usuario de la instancia. |
Extensión | GA |
az iot ops identity show |
Muestra las identidades de instancia. |
Extensión | GA |
az iot ops init |
Arranque el clúster habilitado para Arc para la implementación de operaciones de IoT. |
Extensión | GA |
az iot ops list |
Enumeración de instancias de operaciones de IoT. |
Extensión | GA |
az iot ops schema |
Administración de esquemas y registros. |
Extensión | Vista previa |
az iot ops schema create |
Cree un esquema dentro de un registro de esquema. |
Extensión | Vista previa |
az iot ops schema delete |
Elimine un esquema de destino dentro de un registro de esquema. |
Extensión | Vista previa |
az iot ops schema list |
Enumerar esquemas dentro de un registro de esquema. |
Extensión | Vista previa |
az iot ops schema registry |
Administración del registro de esquemas. |
Extensión | Vista previa |
az iot ops schema registry create |
Cree un registro de esquema. |
Extensión | Vista previa |
az iot ops schema registry delete |
Elimine un registro de esquema de destino. |
Extensión | Vista previa |
az iot ops schema registry list |
Enumera los registros de esquema en un grupo de recursos o una suscripción. |
Extensión | Vista previa |
az iot ops schema registry show |
Mostrar detalles de un registro de esquema. |
Extensión | Vista previa |
az iot ops schema show |
Mostrar detalles de un esquema dentro de un registro de esquema. |
Extensión | Vista previa |
az iot ops schema show-dataflow-refs |
Mostrar las referencias de esquema usadas para los flujos de datos. |
Extensión | Experimental |
az iot ops schema version |
Administración de versiones de esquema. |
Extensión | Vista previa |
az iot ops schema version add |
Agregue una versión de esquema a un esquema. |
Extensión | Vista previa |
az iot ops schema version list |
Enumerar las versiones de esquema para un esquema específico. |
Extensión | Vista previa |
az iot ops schema version remove |
Quite una versión de esquema de destino. |
Extensión | Vista previa |
az iot ops schema version show |
Mostrar detalles de una versión de esquema. |
Extensión | Vista previa |
az iot ops secretsync |
Administración de sincronización de secretos de instancia. |
Extensión | Vista previa |
az iot ops secretsync disable |
Deshabilite la sincronización de secretos para una instancia. |
Extensión | Vista previa |
az iot ops secretsync enable |
Habilite la sincronización de secretos para una instancia. |
Extensión | Vista previa |
az iot ops secretsync list |
Enumere las configuraciones de sincronización de secretos asociadas a una instancia. |
Extensión | Vista previa |
az iot ops show |
Mostrar una instancia de operaciones de IoT. |
Extensión | GA |
az iot ops support |
Operaciones de IoT admiten operaciones. |
Extensión | Vista previa |
az iot ops support create-bundle |
Crea un archivo zip de agrupación de compatibilidad estándar para su uso en la solución de problemas y diagnósticos. |
Extensión | Vista previa |
az iot ops update |
Actualice una instancia de operaciones de IoT. |
Extensión | GA |
az iot ops upgrade |
Actualice una instancia de IoT Operations a la versión más reciente. |
Extensión | Obsolescente |
az iot ops check
Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Evalúe la preparación del lado clúster y el estado en tiempo de ejecución de los servicios de operaciones de IoT implementados.
El comando muestra de forma predeterminada una vista de resumen de alto nivel de todos los servicios.
Use la opción "--svc" para especificar comprobaciones de un único servicio y configurar la detalle a través del --detail-level
argumento .
Nota: El filtrado de tipo de recurso (--resources) y nombre (--resource-name) solo se puede usar con el argumento "--svc".
{API de servicio compatibles}
- deviceregistry.microsoft.com/[v1]
- mqttbroker.iotoperations.azure.com/[v1]
- opcuabroker.iotoperations.azure.com/[v1beta1]
- connectivity.iotoperations.azure.com/[v1]
Para más información sobre los requisitos del clúster, consulte https://aka.ms/iot-ops-cluster-requirements.
az iot ops check [--as-object {false, true}]
[--context]
[--detail-level {0, 1, 2}]
[--ops-service {akri, broker, dataflow, deviceregistry, opcua}]
[--post {false, true}]
[--pre {false, true}]
[--resource-name]
[--resources {asset, assetendpointprofile, assettype, broker, brokerlistener, dataflow, dataflowendpoint, dataflowprofile}]
Ejemplos
Uso básico. Comprueba el estado general de las operaciones de IoT con la salida de resumen.
az iot ops check
Comprueba el estado y la configuración del servicio "broker" con la salida detallada.
az iot ops check --svc broker --detail-level 1
Evalúe solo el servicio "flujo de datos" con la salida optimizada para CI.
az iot ops check --svc dataflow --as-object
Comprueba el estado de "deviceregistry" con salida detallada, pero restringe los resultados a los recursos "asset".
az iot ops check --svc deviceregistry --detail-level 2 --resources asset
Use el nombre del recurso para restringir los resultados a los recursos "asset" con el prefijo de nombre "my-asset-".
az iot ops check --svc deviceregistry --resources asset --resource-name 'my-asset-*'
Parámetros opcionales
Comprobación de contenido y validaciones de salida en una estructura de datos descriptivo de CI.
Nombre de contexto de Kubeconfig que se va a usar para la comunicación de clúster k8s. Si no se proporciona ningún contexto current_context se usa.
Controla el nivel de detalle mostrado en la salida de comprobación. Elija 0 para una vista de resumen (salida mínima), 1 para obtener una vista detallada (información más completa) o 2 para una vista detallada (toda la información disponible).
Implementación del servicio IoT Operations que se evaluará.
Ejecute comprobaciones posteriores a la implementación.
Ejecute comprobaciones de requisitos previos para determinar si se cumplen los requisitos mínimos de una implementación de servicio.
Solo se ejecutan comprobaciones para el nombre de recurso específico. El nombre distingue mayúsculas de minúsculas. Se admiten los patrones de Glob '' y '?'. Nota: Solo se permiten caracteres alfanuméricos, guiones, "?" y "".
Ejecute solo comprobaciones en tipos de recursos específicos. Use valores separados por espacios.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az iot ops create
Cree una instancia de IoT Operations.
Se requiere una ejecución correcta de init antes de ejecutar este comando.
El resultado del comando establece una instancia de IoT Operations con un conjunto de recursos predeterminados configurados para la función cohesiva.
az iot ops create --cluster
--name
--resource-group
--sr-resource-id
[--add-insecure-listener {false, true}]
[--bp]
[--br]
[--broker-backend-workers]
[--broker-config-file]
[--broker-frontend-replicas]
[--broker-frontend-workers]
[--broker-listener-type {ClusterIp, LoadBalancer, NodePort}]
[--broker-mem-profile {High, Low, Medium, Tiny}]
[--cluster-namespace]
[--custom-location]
[--description]
[--df-profile-instances]
[--enable-rsync {false, true}]
[--kubernetes-distro {K3s, K8s, MicroK8s}]
[--location]
[--no-progress {false, true}]
[--ops-config]
[--ops-train]
[--ops-version]
[--runtime-socket]
[--tags]
[--trust-settings]
Ejemplos
Cree la instancia de destino con una entrada mínima.
az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID
En el ejemplo siguiente se agrega personalización al recurso de instancia de broker predeterminado, así como una descripción y etiquetas de instancia.
az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --broker-mem-profile High --broker-backend-workers 4 --description 'Contoso Factory' --tags tier=testX1
En este ejemplo se muestra la implementación de un agente de escucha de agente no seguro adicional (sin autenticación o authz) configurado para el puerto 1883 del equilibrador de carga de tipo de servicio. Útil para pruebas o demostraciones. No use la opción no segura en producción.
az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --add-insecure-listener
En este formulario se muestra cómo habilitar la sincronización de recursos para la implementación de la instancia. Para habilitar la escritura de asignación de roles de sincronización de recursos es necesaria en el grupo de recursos de destino.
az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --enable-rsync
En este ejemplo se resalta la configuración de confianza de un usuario proporcionado por cert-manager config. Tenga en cuenta que el clúster debe haberse inicializado con "--user-trust" y que debe haber una implementación de cert-manager de usuario.
az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --trust-settings configMapName=example-bundle configMapKey=trust-bundle.pem issuerKind=ClusterIssuer issuerName=trust-manager-selfsigned-issuer
Parámetros requeridos
Nombre de clúster de destino para la implementación de operaciones de IoT.
Nombre de instancia de IoT Operations.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Identificador de recurso del Registro de esquema que se va a usar con operaciones de IoT.
Parámetros opcionales
Cuando se habilite la implementación del agente mqtt, se incluirá un agente de escucha del tipo de servicio LoadBalancer, enlazado al puerto 1883 sin autenticación ni autenticaciónZ. Solo para cargas de trabajo que no son de producción.
Particiones de back-end del agente mqtt. Valor mínimo: 1, valor máximo: 16.
Factor de redundancia de back-end del agente mqtt. Valor mínimo: 1, valor máximo: 5.
Trabajos de back-end del agente mqtt. Valor mínimo: 1, valor máximo: 16.
Ruta de acceso a un archivo json con propiedades de configuración de broker personalizadas. El contenido de la configuración del archivo se usa a través de parámetros de configuración de agente individuales. Útil para escenarios avanzados. El formato esperado se describe en https://aka.ms/aziotops-broker-config.
Réplicas de front-end del agente mqtt. Valor mínimo: 1, valor máximo: 16.
Trabajos de front-end del agente mqtt. Valor mínimo: 1, valor máximo: 16.
Tipo de servicio asociado al agente de escucha de mqtt broker predeterminado.
Perfil de memoria del agente mqtt.
El espacio de nombres del clúster en el que se implementará la infraestructura de operaciones de IoT. Debe estar en minúscula.
Nombre de ubicación personalizado correspondiente a la implementación de operaciones de IoT. El valor predeterminado está en el formato 'location-{hash(5)}'.
Descripción de la instancia de operaciones de IoT.
Recuento de instancias asociado al perfil de flujo de datos predeterminado.
Las reglas de sincronización de recursos se incluirán en la implementación de operaciones de IoT.
La distribución de Kubernetes que se va a usar para la configuración de Akri. La distribución seleccionada implica la ruta de acceso de socket del entorno de ejecución del contenedor predeterminada cuando no se proporciona ningún valor de socket --runtime-socket.
Región que se usará para la garantía de recursos aprovisionada. Si no se proporciona la ubicación del clúster conectado, se usará.
Deshabilite la representación visual del trabajo.
Configuración personalizada de la extensión de IoT Operations Arc. El formato es pares clave=valor separados por espacio. --ops-config se puede usar una o varias veces. Para casos de uso avanzados.
El argumento "ops_train" está en desuso y se quitará en una versión futura.
Use para invalidar el entrenamiento de versión de la extensión de IoT Operations Arc integrada.
El argumento "ops_version" ha quedado en desuso y se quitará en una versión futura.
Use para invalidar la versión de extensión integrada de IoT Operations arc.
Ruta de acceso de nodo predeterminada del socket en tiempo de ejecución del contenedor. Si no se proporciona (valor predeterminado), la ruta de acceso del socket viene determinada por --kubernetes-distro.
Etiquetas de instancia. Contenedor de propiedades en pares clave-valor con el formato siguiente: a=b c=d. Use --tags "" para quitar todas las etiquetas.
Configuración de la agrupación de confianza proporcionada por el usuario. Se usa para TLS del componente. El formato es pares clave=valor separados por espacio. Se requieren las siguientes claves: issuerName
, issuerKind
, configMapName
, configMapKey
. Si no se usa, se configura un conjunto de confianza autofirmado proporcionado por el sistema.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az iot ops delete
Elimine las operaciones de IoT del clúster.
Se debe proporcionar el nombre de la instancia o del clúster.
La operación usa Azure Resource Graph para determinar los recursos correlacionados. Resource Graph es coherente finalmente no garantiza un estado sincronizado en el momento de la ejecución.
az iot ops delete --resource-group
[--cluster]
[--force {false, true}]
[--include-deps {false, true}]
[--name]
[--no-progress {false, true}]
[--yes {false, true}]
Ejemplos
Entrada mínima para la eliminación completa.
az iot ops delete -n myinstance -g myresourcegroup
Omita el mensaje de confirmación y continúe con el proceso de eliminación. Útil para escenarios de CI.
az iot ops delete -n myinstance -g myresourcegroup -y
Forzar eliminación independientemente de las advertencias. Puede provocar errores.
az iot ops delete -n myinstance -g myresourcegroup --force
Use el nombre del clúster en lugar de la instancia de para la búsqueda.
az iot ops delete --cluster mycluster -g myresourcegroup
Aplicación inversa de init.
az iot ops delete -n myinstance -g myresourcegroup --include-deps
Parámetros requeridos
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Nombre del clúster de destino para la eliminación de operaciones de IoT.
Forzar la ejecución de la operación.
Indica que el comando debe quitar las dependencias de operaciones de IoT. Esta opción está pensada para invertir la aplicación de init.
Nombre de instancia de IoT Operations.
Deshabilite la representación visual del trabajo.
Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az iot ops init
Arranque el clúster habilitado para Arc para la implementación de operaciones de IoT.
Se requiere un clúster habilitado para Arc para implementar operaciones de IoT. Consulte el siguiente recurso para obtener más información https://aka.ms/aziotops-arcconnect.
La operación de inicialización funcionará en la instalación y configuración de una capa básica de servicios perimetrales necesarios para la implementación de operaciones de IoT.
Una vez instalada la capa de base, se debe usar el az iot ops create
comando para implementar una instancia.
az iot ops init --cluster
--resource-group
[--enable-fault-tolerance {false, true}]
[--ensure-latest {false, true}]
[--no-progress {false, true}]
[--user-trust {false, true}]
Ejemplos
Uso con entrada mínima. Este formulario implementará la capa de Base de operaciones de IoT.
az iot ops init --cluster mycluster -g myresourcegroup
Similar al ejemplo anterior, pero con la tolerancia a errores de Arc Container Storage habilitada (requiere al menos 3 nodos).
az iot ops init --cluster mycluster -g myresourcegroup --enable-fault-tolerance
En este ejemplo se resalta la habilitación de la configuración de confianza del usuario para una configuración personalizada de cert-manager. Esto omitirá la implementación del administrador de certificados del sistema y trust-manager.
az iot ops init --cluster mycluster -g myresourcegroup --user-trust
Parámetros requeridos
Nombre de clúster de destino para la implementación de operaciones de IoT.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Habilite la tolerancia a errores para Azure Arc Container Storage. Se requieren al menos 3 nodos de clúster.
Asegúrese de que se usa la CLI de IoT Ops más reciente, lo que genera un error si hay disponible una actualización.
Deshabilite la representación visual del trabajo.
Omita la implementación del administrador de certificados del sistema y trust-manager en favor de una configuración proporcionada por el usuario.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az iot ops list
Enumeración de instancias de operaciones de IoT.
Use --query con la sintaxis de JMESPath deseada para consultar el resultado.
az iot ops list [--resource-group]
Ejemplos
Enumere todas las instancias de la suscripción.
az iot ops list
Enumera todas las instancias de un grupo de recursos determinado.
az iot ops list -g myresourcegroup
Enumere las instancias de la suscripción que tienen un valor de etiqueta determinado.
az iot ops list -g myresourcegroup --query "[?tags.env == 'prod']"
Parámetros opcionales
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az iot ops show
Mostrar una instancia de operaciones de IoT.
Opcionalmente, el comando puede generar una estructura de árbol de los recursos asociados que representan la implementación de operaciones de IoT en el clúster de respaldo.
az iot ops show --name
--resource-group
[--tree {false, true}]
Ejemplos
Uso básico para mostrar una instancia.
az iot ops show --name myinstance -g myresourcegroup
Genera una estructura de árbol de recursos asociados que representa la implementación de operaciones de IoT.
az iot ops show --name myinstance -g myresourcegroup --tree
Parámetros requeridos
Nombre de instancia de IoT Operations.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Use para visualizar la implementación de operaciones de IoT en el clúster de respaldo.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az iot ops update
Actualice una instancia de operaciones de IoT.
Actualmente, se pueden actualizar las etiquetas y la descripción de la instancia.
az iot ops update --name
--resource-group
[--description]
[--tags]
Ejemplos
Actualizar etiquetas de instancia. Esto equivale a un reemplazo.
az iot ops update --name myinstance -g myresourcegroup --tags a=b c=d
Quite las etiquetas de instancia.
az iot ops update --name myinstance -g myresourcegroup --tags ""
Actualice la descripción de la instancia.
az iot ops update --name myinstance -g myresourcegroup --desc "Fabrikam Widget Factory B42"
Parámetros requeridos
Nombre de instancia de IoT Operations.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Descripción de la instancia de operaciones de IoT.
Etiquetas de instancia. Contenedor de propiedades en pares clave-valor con el formato siguiente: a=b c=d. Use --tags "" para quitar todas las etiquetas.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az iot ops upgrade
Este comando ha quedado en desuso y se quitará en una versión futura.
Actualice una instancia de IoT Operations a la versión más reciente.
ADVERTENCIA: Este comando puede producir un error y requerir que elimine y vuelva a crear el clúster y la instancia.
Actualice una instancia de IoT Operations, incluida la actualización de las extensiones a las versiones más recientes.
Use este comando si az iot ops show
se producen errores o comandos similares.
El identificador de recurso del Registro de esquema es un parámetro opcional y puede ser necesario en escenarios específicos.
az iot ops upgrade --name
--resource-group
[--no-progress {false, true}]
[--sr-resource-id]
[--yes {false, true}]
Ejemplos
Actualice la instancia con entradas mínimas.
az iot ops upgrade --name myinstance -g myresourcegroup
Omita el símbolo del sistema de conformación durante la actualización de la instancia.
az iot ops upgrade --name myinstance -g myresourcegroup -y
Actualice la instancia y especifique el identificador de recurso del Registro de esquema.
az iot ops upgrade --name myinstance -g myresourcegroup --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID
Parámetros requeridos
Nombre de instancia de IoT Operations.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Deshabilite la representación visual del trabajo.
Identificador de recurso del Registro de esquema que se va a usar con operaciones de IoT. Obligatorio si el identificador de recurso del Registro de esquema ya no se encuentra en operaciones de IoT.
Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.