az iot ops
Nota:
Esta referencia forma parte de la extensión azure-iot-ops para la CLI de Azure (versión 2.62.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az iot ops . 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 | Disponibilidad general |
az iot ops asset create |
Cree un recurso. |
Extensión | Disponibilidad general |
az iot ops asset dataset |
Administrar conjuntos de datos en un recurso. |
Extensión | Disponibilidad general |
az iot ops asset dataset list |
Enumerar conjuntos de datos dentro de un recurso. |
Extensión | Disponibilidad general |
az iot ops asset dataset point |
Administrar puntos de datos en un conjunto de datos de recursos. |
Extensión | Disponibilidad general |
az iot ops asset dataset point add |
Agregue un punto de datos a un conjunto de datos de recursos. |
Extensión | Disponibilidad general |
az iot ops asset dataset point export |
Exportar puntos de datos en un conjunto de datos de recursos. |
Extensión | Disponibilidad general |
az iot ops asset dataset point import |
Importe puntos de datos en un conjunto de datos de recursos. |
Extensión | Disponibilidad general |
az iot ops asset dataset point list |
Enumeración de puntos de datos en un conjunto de datos de recursos. |
Extensión | Disponibilidad general |
az iot ops asset dataset point remove |
Quite un punto de datos de un conjunto de datos de recursos. |
Extensión | Disponibilidad general |
az iot ops asset dataset show |
Mostrar un conjunto de datos dentro de un recurso. |
Extensión | Disponibilidad general |
az iot ops asset delete |
Eliminar un recurso. |
Extensión | Disponibilidad general |
az iot ops asset endpoint |
Administrar perfiles de punto de conexión de recursos. |
Extensión | Disponibilidad general |
az iot ops asset endpoint create |
Cree perfiles de punto de conexión de recursos. |
Extensión | Disponibilidad general |
az iot ops asset endpoint create opcua |
Cree un perfil de punto de conexión de recurso para un conector OPCUA. |
Extensión | Disponibilidad general |
az iot ops asset endpoint delete |
Elimine un perfil de punto de conexión de recurso. |
Extensión | Disponibilidad general |
az iot ops asset endpoint query |
Consulte resource Graph para ver los perfiles de punto de conexión de recursos. |
Extensión | Disponibilidad general |
az iot ops asset endpoint show |
Mostrar un perfil de punto de conexión de recurso. |
Extensión | Disponibilidad general |
az iot ops asset endpoint update |
Actualice un perfil de punto de conexión de recurso. |
Extensión | Disponibilidad general |
az iot ops asset event |
Administrar eventos en un recurso. |
Extensión | Disponibilidad general |
az iot ops asset event add |
Agregue un evento a un recurso. |
Extensión | Disponibilidad general |
az iot ops asset event export |
Exportar eventos en un recurso. |
Extensión | Disponibilidad general |
az iot ops asset event import |
Importar eventos en un recurso. |
Extensión | Disponibilidad general |
az iot ops asset event list |
Enumerar eventos en un recurso. |
Extensión | Disponibilidad general |
az iot ops asset event remove |
Quite un evento en un recurso. |
Extensión | Disponibilidad general |
az iot ops asset query |
Consulte resource Graph para los recursos. |
Extensión | Disponibilidad general |
az iot ops asset show |
Mostrar un recurso. |
Extensión | Disponibilidad general |
az iot ops asset update |
Actualice un recurso. |
Extensión | Disponibilidad general |
az iot ops broker |
Administración del agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker authn |
Administración de la autenticación del agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker authn apply |
Cree o reemplace un recurso de autenticación de agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker authn delete |
Elimine un recurso de autenticación de agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker authn list |
Enumera los recursos de autenticación de agente mqtt asociados a un agente. |
Extensión | Disponibilidad general |
az iot ops broker authn method |
Operaciones de método de autenticación del agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker authn method add |
Agregue métodos de autenticación a un recurso de autenticación de agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker authn show |
Mostrar detalles de un recurso de autenticación de agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker authz |
Administración de la autorización del agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker authz apply |
Cree o reemplace un recurso de autorización de agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker authz delete |
Elimine un recurso de autorización de agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker authz list |
Enumera los recursos de autorización del agente mqtt asociados a un agente. |
Extensión | Disponibilidad general |
az iot ops broker authz show |
Muestra los detalles de un recurso de autorización de agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker list |
Enumerar agentes mqtt asociados a una instancia de . |
Extensión | Disponibilidad general |
az iot ops broker listener |
Administración del agente de escucha de Mqtt. |
Extensión | Disponibilidad general |
az iot ops broker listener apply |
Cree o reemplace un servicio de agente de escucha de mqtt broker. |
Extensión | Disponibilidad general |
az iot ops broker listener delete |
Elimine un agente de escucha de mqtt broker. |
Extensión | Disponibilidad general |
az iot ops broker listener list |
Enumera los agentes de escucha de agente mqtt asociados a un agente. |
Extensión | Disponibilidad general |
az iot ops broker listener port |
Operaciones de puerto del agente de escucha del agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker listener port add |
Agregue una configuración de puerto tcp a un servicio de escucha de agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker listener port remove |
Quite una configuración de puerto tcp de un servicio de escucha de agente mqtt. |
Extensión | Disponibilidad general |
az iot ops broker listener show |
Muestra los detalles de un agente de escucha de mqtt. |
Extensión | Disponibilidad general |
az iot ops broker show |
Mostrar detalles de un agente mqtt. |
Extensión | Disponibilidad general |
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 | Versión preliminar |
az iot ops clone |
Clone una instancia. |
Extensión | Versión preliminar |
az iot ops connector |
Administración de conectores. |
Extensión | Versión preliminar |
az iot ops connector opcua |
Administración del conector de OPC UA. |
Extensión | Versión preliminar |
az iot ops connector opcua client |
Administre el certificado de instancia de aplicación cliente de nivel empresarial para OPC UA Broker. |
Extensión | Versión preliminar |
az iot ops connector opcua client add |
Agregue un certificado de instancia de aplicación cliente de nivel empresarial. |
Extensión | Versión preliminar |
az iot ops connector opcua client remove |
Quite el certificado de instancia de aplicación cliente del Agente de OPC UA. |
Extensión | Versión preliminar |
az iot ops connector opcua client show |
Muestra los detalles del recurso secretsync "aio-opc-ua-broker-client-certificate". |
Extensión | Versión preliminar |
az iot ops connector opcua issuer |
Administrar certificados de emisor para el agente de OPC UA. |
Extensión | Versión preliminar |
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 | Versión preliminar |
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 | Versión preliminar |
az iot ops connector opcua issuer show |
Mostrar detalles del recurso secretsync "aio-opc-ua-broker-issuer-list". |
Extensión | Versión preliminar |
az iot ops connector opcua trust |
Administrar certificados de confianza para el agente de OPC UA. |
Extensión | Versión preliminar |
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 | Versión preliminar |
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 | Versión preliminar |
az iot ops connector opcua trust show |
Mostrar detalles del recurso secretsync "aio-opc-ua-broker-trust-list". |
Extensión | Versión preliminar |
az iot ops create |
Cree una instancia de IoT Operations. |
Extensión | Disponibilidad general |
az iot ops dataflow |
Administración del flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow apply |
Cree o reemplace un flujo de datos asociado a un perfil de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow delete |
Elimine un flujo de datos asociado a un perfil de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint |
Administración de puntos de conexión de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint apply |
Cree o reemplace un recurso de punto de conexión de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint create |
Cree o reemplace un recurso de punto de conexión de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint create adls |
Cree o reemplace un recurso de punto de conexión de flujo de datos para Azure Data Lake Storage Gen2. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint create adx |
Cree o reemplace un recurso de punto de conexión de flujo de datos para Azure Data Explorer. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint create custom-kafka |
Cree o reemplace un recurso de punto de conexión de flujo de datos para el agente de kafka personalizado. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint create custom-mqtt |
Cree o reemplace un recurso de punto de conexión de flujo de datos para el agente MQTT personalizado. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint create eventgrid |
Cree o reemplace un recurso de punto de conexión de flujo de datos para Azure Event Grid. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint create eventhub |
Cree o reemplace un recurso de punto de conexión de flujo de datos para el espacio de nombres de Azure Event Hubs habilitado para kafka. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint create fabric-onelake |
Cree o reemplace un recurso de punto de conexión de flujo de datos para Microsoft Fabric OneLake. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint create fabric-realtime |
Cree o reemplace un punto de conexión de flujo de datos de Inteligencia de Microsoft Fabric Real-Time. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint create local-mqtt |
Cree o reemplace un punto de conexión de flujo de datos MQTT local de Azure IoT Operations. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint create local-storage |
Cree o reemplace un punto de conexión de flujo de datos de almacenamiento local. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint delete |
Elimine un recurso de punto de conexión de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint list |
Enumera los recursos del punto de conexión de flujo de datos asociados a una instancia. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint show |
Mostrar detalles de un recurso de punto de conexión de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint update |
Actualice las propiedades de un recurso de punto de conexión de flujo de datos existente. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint update adls |
Actualice las propiedades de un recurso de punto de conexión de flujo de datos existente para Azure Data Lake Storage Gen2. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint update adx |
Actualice las propiedades de un recurso de punto de conexión de flujo de datos existente para Azure Data Explorer. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint update custom-kafka |
Actualice las propiedades de un recurso de punto de conexión de flujo de datos existente para el agente de kafka personalizado. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint update custom-mqtt |
Actualice las propiedades de un recurso de punto de conexión de flujo de datos existente para el agente MQTT personalizado. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint update eventgrid |
Actualice las propiedades de un recurso de punto de conexión de flujo de datos existente para Azure Event Grid. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint update eventhub |
Actualice las propiedades de un recurso de punto de conexión de flujo de datos existente para el espacio de nombres de Azure Event Hubs habilitado para kafka. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint update fabric-onelake |
Actualice las propiedades de un recurso de punto de conexión de flujo de datos existente para Microsoft Fabric OneLake. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint update fabric-realtime |
Actualice las propiedades de un punto de conexión de flujo de datos de Inteligencia de Microsoft Fabric existente Real-Time. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint update local-mqtt |
Actualice las propiedades de un punto de conexión de flujo de datos MQTT local de operaciones de Azure IoT existente. |
Extensión | Disponibilidad general |
az iot ops dataflow endpoint update local-storage |
Actualice las propiedades de un punto de conexión de flujo de datos de almacenamiento local existente. |
Extensión | Disponibilidad general |
az iot ops dataflow list |
Enumera los flujos de datos asociados a un perfil de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow profile |
Administración de perfiles de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow profile create |
Cree o reemplace un perfil de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow profile delete |
Elimine un perfil de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow profile list |
Enumera los perfiles de flujo de datos asociados a una instancia de . |
Extensión | Disponibilidad general |
az iot ops dataflow profile show |
Mostrar detalles de un perfil de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow profile update |
Actualice un perfil de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops dataflow show |
Mostrar detalles de un flujo de datos asociado a un perfil de flujo de datos. |
Extensión | Disponibilidad general |
az iot ops delete |
Elimine las operaciones de IoT del clúster. |
Extensión | Disponibilidad general |
az iot ops identity |
Administración de identidades de instancia. |
Extensión | Disponibilidad general |
az iot ops identity assign |
Asigne una identidad administrada asignada por el usuario con la instancia de . |
Extensión | Disponibilidad general |
az iot ops identity remove |
Quite una identidad administrada asignada por el usuario de la instancia. |
Extensión | Disponibilidad general |
az iot ops identity show |
Muestra las identidades de instancia. |
Extensión | Disponibilidad general |
az iot ops init |
Arranque el clúster habilitado para Arc para la implementación de operaciones de IoT. |
Extensión | Disponibilidad general |
az iot ops list |
Enumeración de instancias de operaciones de IoT. |
Extensión | Disponibilidad general |
az iot ops rsync |
Administración de reglas de sincronización de recursos. |
Extensión | Versión preliminar |
az iot ops rsync disable |
Deshabilite la hidratación perimetral a la nube mediante la eliminación de reglas de sincronización de recursos asociadas a la instancia. |
Extensión | Versión preliminar |
az iot ops rsync enable |
Habilite edge to cloud hidratación mediante la creación de reglas de sincronización de recursos para la instancia. |
Extensión | Versión preliminar |
az iot ops rsync list |
Enumera las reglas de sincronización de recursos asociadas a la instancia. |
Extensión | Versión preliminar |
az iot ops schema |
Administración de esquemas y registros. |
Extensión | Versión preliminar |
az iot ops schema create |
Cree un esquema dentro de un registro de esquema. |
Extensión | Versión preliminar |
az iot ops schema delete |
Elimine un esquema de destino dentro de un registro de esquema. |
Extensión | Versión preliminar |
az iot ops schema list |
Enumerar esquemas dentro de un registro de esquema. |
Extensión | Versión preliminar |
az iot ops schema registry |
Administración del registro de esquemas. |
Extensión | Versión preliminar |
az iot ops schema registry create |
Cree un registro de esquema. |
Extensión | Versión preliminar |
az iot ops schema registry delete |
Elimine un registro de esquema de destino. |
Extensión | Versión preliminar |
az iot ops schema registry list |
Enumera los registros de esquema en un grupo de recursos o una suscripción. |
Extensión | Versión preliminar |
az iot ops schema registry show |
Mostrar detalles de un registro de esquema. |
Extensión | Versión preliminar |
az iot ops schema show |
Mostrar detalles de un esquema dentro de un registro de esquema. |
Extensión | Versión preliminar |
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 | Versión preliminar |
az iot ops schema version add |
Agregue una versión de esquema a un esquema. |
Extensión | Versión preliminar |
az iot ops schema version list |
Enumerar las versiones de esquema para un esquema específico. |
Extensión | Versión preliminar |
az iot ops schema version remove |
Quite una versión de esquema de destino. |
Extensión | Versión preliminar |
az iot ops schema version show |
Mostrar detalles de una versión de esquema. |
Extensión | Versión preliminar |
az iot ops secretsync |
Administración de sincronización de secretos de instancia. |
Extensión | Versión preliminar |
az iot ops secretsync disable |
Deshabilite la sincronización de secretos para una instancia. |
Extensión | Versión preliminar |
az iot ops secretsync enable |
Habilite la sincronización de secretos para una instancia. |
Extensión | Versión preliminar |
az iot ops secretsync list |
Enumere las configuraciones de sincronización de secretos asociadas a una instancia. |
Extensión | Versión preliminar |
az iot ops show |
Mostrar una instancia de operaciones de IoT. |
Extensión | Disponibilidad general |
az iot ops support |
Operaciones de IoT admiten operaciones. |
Extensión | Versión preliminar |
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 | Versión preliminar |
az iot ops update |
Actualice una instancia de operaciones de IoT. |
Extensión | Disponibilidad general |
az iot ops upgrade |
Actualice una instancia de IoT Operations. |
Extensión | Disponibilidad general |
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]
- 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 --svc {akri, broker, dataflow, deviceregistry, opcua}]
[--post {false, true}]
[--pre {false, true}]
[--resource-name --rn]
[--resources {asset, assetendpointprofile, broker, brokerauthentication, brokerauthorization, 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 no 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 del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Usa --debug para ver registros de depuración completos.
az iot ops clone
Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Clone una instancia.
Clone analiza una instancia y, a continuación, la reproduce de forma de infraestructura como código a través de plantillas de ARM.
La salida del clon se puede aplicar directamente a otro clúster conectado (denominado replicación) o guardarlo localmente para usarlo en otro momento con posibles modificaciones.
La definición de clonación es una plantilla de ARM genérica, se puede implementar a través de herramientas existentes. Consulte https://aka.ms/aio-clone para obtener más información.
Clone es compatible con el siguiente intervalo de versiones de instancia: 1.0.34>=,<1.2.0
.
az iot ops clone --name
--resource-group
[--base-uri]
[--force {false, true}]
[--mode {linked, nested}]
[--no-progress {false, true}]
[--param]
[--self-hosted-issuer {false, true}]
[--summary {detailed, simple}]
[--to-cluster-id]
[--to-dir]
[--yes {false, true}]
Ejemplos
Clone una instancia de en un clúster conectado deseado.
az iot ops clone -n myinstance -g myresourcegroup --to-cluster-id $CLUSTER_RESOURCE_ID
Clone una instancia de en un clúster conectado deseado, con replicación personalizada.
az iot ops clone -n myinstance -g myresourcegroup --to-cluster-id $CLUSTER_RESOURCE_ID --param location=eastus
Clone una instancia de en un clúster conectado deseado, pero divida y aplique en serie las sub-implementaciones relacionadas con los recursos.
az iot ops clone -n myinstance -g myresourcegroup --to-cluster-id $CLUSTER_RESOURCE_ID --mode linked
Clone una instancia en un directorio local.
az iot ops clone -n myinstance -g myresourcegroup --to-dir .
Clone una instancia de en un directorio local, pero divida y vincule a las sub-implementaciones relacionadas con los recursos.
az iot ops clone -n myinstance -g myresourcegroup --to-dir /my/content --mode linked
Ocultar las visualizaciones de progreso y omitir avisos.
az iot ops clone -n myinstance -g myresourcegroup --to-dir . --no-progress -y
Parámetros requeridos
Instancia del modelo que se va a clonar.
El grupo de recursos en el que se va a clonar la instancia del modelo reside.
Parámetros opcionales
URI base que se va a usar para vínculos de plantilla. Si no se proporciona una estrategia de ruta de acceso relativa, se usará. Relevante cuando --mode está establecido en "vinculado". Ejemplo: https://raw.githubusercontent.com/myorg/myproject/main/myclones/
.
Forzar la ejecución de la operación.
Cuando se usa el modo "anidado", las sub-implementaciones estarán independientes en la implementación raíz. Cuando se usa el modo "vinculado", las sub-implementaciones relacionadas con los recursos se dividirán y almacenarán como archivos independientes vinculados por la implementación raíz.
Deshabilite la representación visual del trabajo.
El parámetro se invalida al replicar el clon en un clúster conectado. Si se omiten los valores predeterminados de la instancia del modelo se usan. El formato es pares clave=valor separados por espacio, donde la clave representa un parámetro de definición de clonación. Se pueden establecer las siguientes claves: instanceName, clusterName, clusterNamespace, customLocationName, opsExtensionName, schemaRegistryId, resourceSlug, location, applyRoleAssignments. Se puede usar una o varias veces.
Use el emisor oidc autohospedado para la federación. Solo es aplicable si las identidades administradas asignadas por el usuario están asociadas a la instancia del modelo.
Opción de resumen de implementación.
El identificador de recurso del clúster conectado al que se aplicará el clon.
El directorio local en el que se almacenarán las definiciones de clonación de instancia.
Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Usa --debug para ver 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.
Para habilitar la hidratación de recursos perimetrales en la nube, use el comando después de la creación de la az iot ops rsync enable
instancia.
az iot ops create --cluster
--name
--resource-group
--sr-resource-id
[--add-insecure-listener {false, true}]
[--bp --broker-backend-part]
[--br --broker-backend-rf]
[--broker-backend-workers --bw]
[--broker-config-file]
[--broker-frontend-replicas --fr]
[--broker-frontend-workers --fw]
[--broker-mem-profile --mp {High, Low, Medium, Tiny}]
[--cluster-namespace]
[--custom-location]
[--description]
[--df-profile-instances]
[--enable-rsync {false, true}]
[--feature]
[--kubernetes-distro {K3s, K8s, MicroK8s}]
[--location]
[--no-progress {false, true}]
[--ops-config]
[--runtime-socket]
[--tags]
[--trust-settings]
[--yes {false, true}]
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
Para configurar características de componente como la configuración de vista previa, use la opción --feature.
az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --feature connectors.settings.preview=Enabled
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.
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.
La opción "--enable-rsync" está en desuso y se quitará en una versión futura. Use "az iot ops rsync enable" en su lugar.
Las reglas de sincronización de recursos se incluirán en la implementación de operaciones de IoT.
Configuración de características de instancia. La configuración de un componente o el modo se puede configurar. La sintaxis del modo componente es {component}.mode={mode}
donde los valores de modo conocidos son: Stable
, Preview
y Disabled
. La sintaxis de configuración de componentes es {component}.settings.{setting}={value}
donde los valores de configuración conocidos son Enabled
o Disabled
. Esta opción se puede usar una o varias veces.
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 arco IotOperations. El formato es pares clave=valor separados por espacio o simplemente la clave. Esta opción se puede usar una o varias veces.
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 separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
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.
Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Usa --debug para ver 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 del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Usa --debug para ver 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.
Nota: Las opciones --*-config permiten invalidar la configuración predeterminada.
Los valores de configuración predeterminados para el almacenamiento de contenedores son: edgeStorageConfiguration.create=true feature.diskStorageClass=default,local-path
Si se usa --enable-fault-tolerance se aplica la siguiente diferencia de configuración al almacenamiento de contenedores: feature.diskStorageClass=acstor-arccontainerstorage-storage-pool acstorConfiguration.create=true acstorConfiguration.properties.diskMountPoint=/mnt
Los valores de configuración predeterminados para el almacén de secretos son: rotationPollIntervalInSeconds=120 validatingAdmissionPolicies.applyPolicies=false.
az iot ops init --cluster
--resource-group
[--acs-config]
[--check-cluster {false, true}]
[--context]
[--enable-fault-tolerance {false, true}]
[--ensure-latest {false, true}]
[--no-progress {false, true}]
[--ssc-config]
[--user-trust --ut {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
Proporcione configuraciones personalizadas en tiempo de implementación para Arc Container Storage.
az iot ops init --cluster mycluster -g myresourcegroup --enable-fault-tolerance --acs-config acstorConfiguration.properties.diskMountPoint=/mnt
Proporcione configuraciones personalizadas en tiempo de implementación para Arc Secret Store.
az iot ops init --cluster mycluster -g myresourcegroup --ssc-config rotationPollIntervalInSeconds=60
Compruebe si el clúster cumple la configuración de requisitos previos necesarios antes de continuar con init. Se requiere un kubeconfig válido con esta opción.
az iot ops init --cluster mycluster -g myresourcegroup --check-cluster
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
Configuración personalizada de la extensión de arc ContainerStorage. El formato es pares clave=valor separados por espacio o simplemente la clave. Esta opción se puede usar una o varias veces.
Aplique una comprobación de los requisitos mínimos del clúster antes de arrancar.
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.
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.
Configuración personalizada de la extensión secretStore arc. El formato es pares clave=valor separados por espacio o simplemente la clave. Esta opción se puede usar una o varias veces.
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 del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Usa --debug para ver 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 del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Usa --debug para ver 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 del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Usa --debug para ver registros de depuración completos.
az iot ops update
Actualice una instancia de operaciones de IoT.
Actualmente, se pueden actualizar las etiquetas de instancia, la descripción y las características.
az iot ops update --name
--resource-group
[--description]
[--feature]
[--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"
Actualice una instancia para habilitar la configuración en versión preliminar de los conectores.
az iot ops update --name myinstance -g myresourcegroup --feature connectors.settings.preview=Enabled
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.
Configuración de características de instancia. La configuración de un componente o el modo se puede configurar. La sintaxis del modo componente es {component}.mode={mode}
donde los valores de modo conocidos son: Stable
, Preview
y Disabled
. La sintaxis de configuración de componentes es {component}.settings.{setting}={value}
donde los valores de configuración conocidos son Enabled
o Disabled
. Esta opción se puede usar una o varias veces.
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Usa --debug para ver registros de depuración completos.
az iot ops upgrade
Actualice una instancia de IoT Operations.
De forma predeterminada, sin opciones, el comando evaluará las versiones de los servicios del lado del clúster implementados que componen las operaciones de IoT y las comparará con la implementación integrada que se ejecutaría con az iot ops init
y az iot ops create
.
az iot ops upgrade --name
--resource-group
[--acs-config]
[--no-progress {false, true}]
[--ops-config]
[--osm-config]
[--plat-config]
[--ssc-config]
[--yes {false, true}]
Ejemplos
Actualice la instancia con entradas mínimas.
az iot ops upgrade --name myinstance -g myresourcegroup
Omita la solicitud de confirmación para la actualización de la instancia. Útil para escenarios de CI.
az iot ops upgrade --name myinstance -g myresourcegroup -y
Establezca la configuración de la extensión que se aplique durante la actualización. Para quitar una configuración, proporcione la clave sin ningún valor.
az iot ops upgrade --name myinstance -g myresourcegroup --ops-config key1=value1 deletekey
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
Configuración personalizada de la extensión de arc ContainerStorage. El formato es pares clave=valor separados por espacio o simplemente la clave. Esta opción se puede usar una o varias veces.
Deshabilite la representación visual del trabajo.
Configuración personalizada de la extensión de arco IotOperations. El formato es pares clave=valor separados por espacio o simplemente la clave. Esta opción se puede usar una o varias veces.
Configuración personalizada de la extensión openServiceMesh arc. El formato es pares clave=valor separados por espacio o simplemente la clave. Esta opción se puede usar una o varias veces.
Configuración personalizada de la extensión de arco de plataforma. El formato es pares clave=valor separados por espacio o simplemente la clave. Esta opción se puede usar una o varias veces.
Configuración personalizada de la extensión secretStore arc. El formato es pares clave=valor separados por espacio o simplemente la clave. Esta opción se puede usar una o varias veces.
Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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 del registro. Usa --debug para ver registros de depuración completos.