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 custom	Cree un perfil de punto de conexión de recurso para un conector personalizado.	Extensión	Obsolescente
az iot ops asset endpoint create onvif	Cree un perfil de punto de conexión de recurso para un conector onvif.	Extensión	Obsolescente
az iot ops asset endpoint create opcua	Cree un perfil de punto de conexión de recurso para 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.	Extensión	GA

az iot ops check

Vista previa

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, 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

--as-object

Comprobación de contenido y validaciones de salida en una estructura de datos descriptivo de CI.

Valores aceptados: false, true

--context

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.

--detail-level

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).

Valores aceptados: 0, 1, 2

Valor predeterminado: 0

--ops-service --svc

Implementación del servicio IoT Operations que se evaluará.

Valores aceptados: akri, broker, dataflow, deviceregistry, opcua

--post

Ejecute comprobaciones posteriores a la implementación.

Valores aceptados: false, true

--pre

Ejecute comprobaciones de requisitos previos para determinar si se cumplen los requisitos mínimos de una implementación de servicio.

Valores aceptados: false, true

--resource-name --rn

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 "".

--resources

Ejecute solo comprobaciones en tipos de recursos específicos. Use valores separados por espacios.

Valores aceptados: asset, assetendpointprofile, assettype, broker, brokerauthentication, brokerauthorization, brokerlistener, dataflow, dataflowendpoint, dataflowprofile

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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]
                  [--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

Parámetros requeridos

--cluster

Nombre de clúster de destino para la implementación de operaciones de IoT.

--name -n

Nombre de instancia de IoT Operations.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--sr-resource-id

Identificador de recurso del Registro de esquema que se va a usar con operaciones de IoT.

Parámetros opcionales

--add-insecure-listener

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.

Valores aceptados: false, true

--bp --broker-backend-part

Particiones de back-end del agente mqtt. Valor mínimo: 1, valor máximo: 16.

Valor predeterminado: 2

--br --broker-backend-rf

Factor de redundancia de back-end del agente mqtt. Valor mínimo: 1, valor máximo: 5.

Valor predeterminado: 2

--broker-backend-workers --bw

Trabajos de back-end del agente mqtt. Valor mínimo: 1, valor máximo: 16.

Valor predeterminado: 2

--broker-config-file

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.

--broker-frontend-replicas --fr

Réplicas de front-end del agente mqtt. Valor mínimo: 1, valor máximo: 16.

Valor predeterminado: 2

--broker-frontend-workers --fw

Trabajos de front-end del agente mqtt. Valor mínimo: 1, valor máximo: 16.

Valor predeterminado: 2

--broker-listener-type --lt

Tipo de servicio asociado al agente de escucha de mqtt broker predeterminado.

Valores aceptados: ClusterIp, LoadBalancer, NodePort

Valor predeterminado: ClusterIp

--broker-mem-profile --mp

Perfil de memoria del agente mqtt.

Valores aceptados: High, Low, Medium, Tiny

Valor predeterminado: Medium

--cluster-namespace

El espacio de nombres del clúster en el que se implementará la infraestructura de operaciones de IoT. Debe estar en minúscula.

Valor predeterminado: azure-iot-operations

--custom-location

Nombre de ubicación personalizado correspondiente a la implementación de operaciones de IoT. El valor predeterminado está en el formato 'location-{hash(5)}'.

--description

Descripción de la instancia de operaciones de IoT.

--df-profile-instances

Recuento de instancias asociado al perfil de flujo de datos predeterminado.

Valor predeterminado: 1

--enable-rsync

Las reglas de sincronización de recursos se incluirán en la implementación de operaciones de IoT.

Valores aceptados: false, true

--kubernetes-distro

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.

Valores aceptados: K3s, K8s, MicroK8s

Valor predeterminado: K8s

--location

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á.

--no-progress

Deshabilite la representación visual del trabajo.

Valores aceptados: false, true

--ops-config

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.

--ops-train

Obsoleto

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.

--ops-version

Obsoleto

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.

--runtime-socket

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.

--tags

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.

--trust-settings

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.

--yes -y

Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.

Valores aceptados: false, true

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--cluster

Nombre del clúster de destino para la eliminación de operaciones de IoT.

--force

Forzar la ejecución de la operación.

Valores aceptados: false, true

--include-deps

Indica que el comando debe quitar las dependencias de operaciones de IoT. Esta opción está pensada para invertir la aplicación de init.

Valores aceptados: false, true

--name -n

Nombre de instancia de IoT Operations.

--no-progress

Deshabilite la representación visual del trabajo.

Valores aceptados: false, true

--yes -y

Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.

Valores aceptados: false, true

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--cluster

Nombre de clúster de destino para la implementación de operaciones de IoT.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--enable-fault-tolerance

Habilite la tolerancia a errores para Azure Arc Container Storage. Se requieren al menos 3 nodos de clúster.

Valores aceptados: false, true

--ensure-latest

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.

Valores aceptados: false, true

--no-progress

Deshabilite la representación visual del trabajo.

Valores aceptados: false, true

--user-trust --ut

Omita la implementación del administrador de certificados del sistema y trust-manager en favor de una configuración proporcionada por el usuario.

Valores aceptados: false, true

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--name -n

Nombre de instancia de IoT Operations.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--tree

Use para visualizar la implementación de operaciones de IoT en el clúster de respaldo.

Valores aceptados: false, true

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

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

--name -n

Nombre de instancia de IoT Operations.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--description

Descripción de la instancia de operaciones de IoT.

--tags

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

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener 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]
                   [--acs-config-sync {add, full, none}]
                   [--acs-train]
                   [--acs-version]
                   [--no-progress {false, true}]
                   [--ops-config]
                   [--ops-config-sync {add, full, none}]
                   [--ops-train]
                   [--ops-version]
                   [--osm-config]
                   [--osm-config-sync {add, full, none}]
                   [--osm-train]
                   [--osm-version]
                   [--plat-config]
                   [--plat-config-sync {add, full, none}]
                   [--plat-train]
                   [--plat-version]
                   [--ssc-config]
                   [--ssc-config-sync {add, full, none}]
                   [--ssc-train]
                   [--ssc-version]
                   [--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

Proporcione una versión o una versión explícitas de operaciones de IoT para actualizar a. No se recomienda para casos de uso típicos.

az iot ops upgrade --name myinstance -g myresourcegroup --ops-version x.y.z --ops-train preview

Parámetros requeridos

--name -n

Nombre de instancia de IoT Operations.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--acs-config

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.

--acs-config-sync

Obsoleto

El argumento "acs_config_sync_mode" está en desuso y se quitará en una versión futura.

Modo de sincronización de configuración de la extensión de arc ContainerStorage. Esta opción es aplicable si se solicita una actualización a una versión conocida. El modo "full" modificará la configuración actual en el destino; "add" solo aplicará cambios aditivos, "none" es un no-op.

Valores aceptados: add, full, none

Valor predeterminado: full

--acs-train

Use para invalidar el entrenamiento de versión de la extensión arc de containerStorage integrada.

--acs-version

Use para invalidar la versión integrada de la extensión arc ContainerStorage.

--no-progress

Deshabilite la representación visual del trabajo.

Valores aceptados: false, true

--ops-config

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.

--ops-config-sync

Obsoleto

El argumento "ops_config_sync_mode" ha quedado en desuso y se quitará en una versión futura.

Modo de sincronización de configuración de la extensión arc de IotOperations. Esta opción es aplicable si se solicita una actualización a una versión conocida. El modo "full" modificará la configuración actual en el destino; "add" solo aplicará cambios aditivos, "none" es un no-op.

Valores aceptados: add, full, none

Valor predeterminado: full

--ops-train

Use para invalidar el entrenamiento de versión de extensión iotOperations arc integrado.

--ops-version

Use para invalidar la versión de extensión iotOperations arc integrada.

--osm-config

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.

--osm-config-sync

Obsoleto

El argumento "osm_config_sync_mode" está en desuso y se quitará en una versión futura.

Modo de sincronización de configuración de la extensión openServiceMesh arc. Esta opción es aplicable si se solicita una actualización a una versión conocida. El modo "full" modificará la configuración actual en el destino; "add" solo aplicará cambios aditivos, "none" es un no-op.

Valores aceptados: add, full, none

Valor predeterminado: full

--osm-train

Use para invalidar el entrenamiento de versión de extensión openServiceMesh arc integrado.

--osm-version

Use para invalidar la versión integrada de la extensión openServiceMesh arc.

--plat-config

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.

--plat-config-sync

Obsoleto

El argumento "plat_config_sync_mode" está en desuso y se quitará en una versión futura.

Modo de sincronización de configuración de extensión de arco de plataforma. Esta opción es aplicable si se solicita una actualización a una versión conocida. El modo "full" modificará la configuración actual en el destino; "add" solo aplicará cambios aditivos, "none" es un no-op.

Valores aceptados: add, full, none

Valor predeterminado: full

--plat-train

Use para invalidar el entrenamiento de versión de la extensión de arco de plataforma integrada.

--plat-version

Use para invalidar la versión de extensión de arco de plataforma integrada.

--ssc-config

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.

--ssc-config-sync

Obsoleto

El argumento "ssc_config_sync_mode" está en desuso y se quitará en una versión futura.

Modo de sincronización de configuración de la extensión secretStore arc. Esta opción es aplicable si se solicita una actualización a una versión conocida. El modo "full" modificará la configuración actual en el destino; "add" solo aplicará cambios aditivos, "none" es un no-op.

Valores aceptados: add, full, none

Valor predeterminado: full

--ssc-train

Use para invalidar el entrenamiento de versión de la extensión secretStore arc integrada.

--ssc-version

Use para invalidar la versión integrada de la extensión secretStore arc.

--yes -y

Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.

Valores aceptados: false, true

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.