Compartir a través de


az iot ops

Nota:

Esta referencia forma parte de la extensión azure-iot-ops para la CLI de Azure (versión 2.53.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az iot ops . Obtenga más información sobre las extensiones.

Administración de operaciones de Azure IoT.

Azure IoT Operations es un conjunto de servicios de Kubernetes altamente alineados, pero acoplados de forma flexible que permiten agregar datos de recursos locales a un agente MQTT de nivel industrial, agregar proceso perimetral y configurar el flujo de datos bidireccional con una variedad de servicios en la nube.

De forma predeterminada, los comandos de la CLI de IoT Operations comprobarán periódicamente si hay disponible una nueva versión de extensión. Este comportamiento se puede deshabilitar con az config set iotops.check_latest=false.

Comandos

Nombre Description Tipo Estado
az iot ops asset

Administración de activos.

Extensión GA
az iot ops asset create

Cree un recurso.

Extensión GA
az iot ops asset dataset

Administrar conjuntos de datos en un recurso.

Extensión GA
az iot ops asset dataset list

Enumerar conjuntos de datos dentro de un recurso.

Extensión GA
az iot ops asset dataset point

Administrar puntos de datos en un conjunto de datos de recursos.

Extensión GA
az iot ops asset dataset point add

Agregue un punto de datos a un conjunto de datos de recursos.

Extensión GA
az iot ops asset dataset point export

Exportar puntos de datos en un conjunto de datos de recursos.

Extensión GA
az iot ops asset dataset point import

Importe puntos de datos en un conjunto de datos de recursos.

Extensión GA
az iot ops asset dataset point list

Enumeración de puntos de datos en un conjunto de datos de recursos.

Extensión GA
az iot ops asset dataset point remove

Quite un punto de datos de un conjunto de datos de recursos.

Extensión GA
az iot ops asset dataset show

Mostrar un conjunto de datos dentro de un recurso.

Extensión GA
az iot ops asset delete

Eliminar un recurso.

Extensión GA
az iot ops asset endpoint

Administrar perfiles de punto de conexión de recursos.

Extensión GA
az iot ops asset endpoint create

Cree perfiles de punto de conexión de recursos.

Extensión GA
az iot ops asset endpoint create opcua

Cree un perfil de punto de conexión de recurso con un conector OPCUA.

Extensión GA
az iot ops asset endpoint delete

Elimine un perfil de punto de conexión de recurso.

Extensión GA
az iot ops asset endpoint query

Consulte resource Graph para ver los perfiles de punto de conexión de recursos.

Extensión GA
az iot ops asset endpoint show

Mostrar un perfil de punto de conexión de recurso.

Extensión GA
az iot ops asset endpoint update

Actualice un perfil de punto de conexión de recurso.

Extensión GA
az iot ops asset event

Administrar eventos en un recurso.

Extensión GA
az iot ops asset event add

Agregue un evento a un recurso.

Extensión GA
az iot ops asset event export

Exportar eventos en un recurso.

Extensión GA
az iot ops asset event import

Importar eventos en un recurso.

Extensión GA
az iot ops asset event list

Enumerar eventos en un recurso.

Extensión GA
az iot ops asset event remove

Quite un evento en un recurso.

Extensión GA
az iot ops asset query

Consulte resource Graph para los recursos.

Extensión GA
az iot ops asset show

Mostrar un recurso.

Extensión GA
az iot ops asset update

Actualice un recurso.

Extensión GA
az iot ops broker

Administración del agente mqtt.

Extensión GA
az iot ops broker authn

Administración de la autenticación del agente.

Extensión GA
az iot ops broker authn delete

Elimine un recurso de autenticación de agente mqtt.

Extensión GA
az iot ops broker authn list

Enumere los recursos de autenticación del agente mqtt asociados a una instancia.

Extensión GA
az iot ops broker authn show

Mostrar detalles de un recurso de autenticación de agente mqtt.

Extensión GA
az iot ops broker authz

Administración de la autorización del agente.

Extensión GA
az iot ops broker authz delete

Elimine un recurso de autorización de agente mqtt.

Extensión GA
az iot ops broker authz list

Enumere los recursos de autorización del agente mqtt asociados a una instancia.

Extensión GA
az iot ops broker authz show

Muestra los detalles de un recurso de autorización de agente mqtt.

Extensión GA
az iot ops broker delete

Elimine un agente mqtt.

Extensión GA
az iot ops broker list

Enumerar agentes mqtt asociados a una instancia de .

Extensión GA
az iot ops broker listener

Administración del agente de escucha.

Extensión GA
az iot ops broker listener delete

Elimine un agente de escucha de mqtt broker.

Extensión GA
az iot ops broker listener list

Enumera los agentes de escucha de agente mqtt asociados a un agente.

Extensión GA
az iot ops broker listener show

Muestra los detalles de un agente de escucha de mqtt.

Extensión GA
az iot ops broker show

Mostrar detalles de un agente mqtt.

Extensión GA
az iot ops check

Evalúe la preparación del lado clúster y el estado en tiempo de ejecución de los servicios de operaciones de IoT implementados.

Extensión Vista previa
az iot ops connector

Administración de conectores.

Extensión Vista previa
az iot ops connector opcua

Administración del conector de OPC UA.

Extensión Vista previa
az iot ops connector opcua client

Administre el certificado de instancia de aplicación cliente de nivel empresarial para OPC UA Broker.

Extensión Vista previa
az iot ops connector opcua client add

Agregue un certificado de instancia de aplicación cliente de nivel empresarial.

Extensión Vista previa
az iot ops connector opcua client remove

Quite el certificado de instancia de aplicación cliente del Agente de OPC UA.

Extensión Vista previa
az iot ops connector opcua client show

Muestra los detalles del recurso secretsync "aio-opc-ua-broker-client-certificate".

Extensión Vista previa
az iot ops connector opcua issuer

Administrar certificados de emisor para el agente de OPC UA.

Extensión Vista previa
az iot ops connector opcua issuer add

Agregue un certificado de emisor a la lista de certificados del emisor del agente de OPC UA.

Extensión Vista previa
az iot ops connector opcua issuer remove

Quite los certificados de confianza de la lista de certificados del emisor del agente de OPC UA.

Extensión Vista previa
az iot ops connector opcua issuer show

Mostrar detalles del recurso secretsync "aio-opc-ua-broker-issuer-list".

Extensión Vista previa
az iot ops connector opcua trust

Administrar certificados de confianza para el agente de OPC UA.

Extensión Vista previa
az iot ops connector opcua trust add

Agregue un certificado de confianza a la lista de certificados de confianza de OPC UA Broker.

Extensión Vista previa
az iot ops connector opcua trust remove

Quite los certificados de confianza de la lista de certificados de confianza de OPC UA Broker.

Extensión Vista previa
az iot ops connector opcua trust show

Mostrar detalles del recurso secretsync "aio-opc-ua-broker-trust-list".

Extensión Vista previa
az iot ops create

Cree una instancia de IoT Operations.

Extensión GA
az iot ops dataflow

Administración del flujo de datos.

Extensión GA
az iot ops dataflow endpoint

Administración de puntos de conexión de flujo de datos.

Extensión GA
az iot ops dataflow endpoint list

Enumera los recursos del punto de conexión de flujo de datos asociados a una instancia.

Extensión GA
az iot ops dataflow endpoint show

Mostrar detalles de un recurso de punto de conexión de flujo de datos.

Extensión GA
az iot ops dataflow list

Enumera los flujos de datos asociados a un perfil de flujo de datos.

Extensión GA
az iot ops dataflow profile

Administración de perfiles de flujo de datos.

Extensión GA
az iot ops dataflow profile list

Enumera los perfiles de flujo de datos asociados a una instancia de .

Extensión GA
az iot ops dataflow profile show

Mostrar detalles de un perfil de flujo de datos.

Extensión GA
az iot ops dataflow show

Mostrar detalles de un flujo de datos asociado a un perfil de flujo de datos.

Extensión GA
az iot ops delete

Elimine las operaciones de IoT del clúster.

Extensión GA
az iot ops identity

Administración de identidades de instancia.

Extensión GA
az iot ops identity assign

Asigne una identidad administrada asignada por el usuario con la instancia de .

Extensión GA
az iot ops identity remove

Quite una identidad administrada asignada por el usuario de la instancia.

Extensión GA
az iot ops identity show

Muestra las identidades de instancia.

Extensión GA
az iot ops init

Arranque el clúster habilitado para Arc para la implementación de operaciones de IoT.

Extensión GA
az iot ops list

Enumeración de instancias de operaciones de IoT.

Extensión GA
az iot ops schema

Administración de esquemas y registros.

Extensión Vista previa
az iot ops schema create

Cree un esquema dentro de un registro de esquema.

Extensión Vista previa
az iot ops schema delete

Elimine un esquema de destino dentro de un registro de esquema.

Extensión Vista previa
az iot ops schema list

Enumerar esquemas dentro de un registro de esquema.

Extensión Vista previa
az iot ops schema registry

Administración del registro de esquemas.

Extensión Vista previa
az iot ops schema registry create

Cree un registro de esquema.

Extensión Vista previa
az iot ops schema registry delete

Elimine un registro de esquema de destino.

Extensión Vista previa
az iot ops schema registry list

Enumera los registros de esquema en un grupo de recursos o una suscripción.

Extensión Vista previa
az iot ops schema registry show

Mostrar detalles de un registro de esquema.

Extensión Vista previa
az iot ops schema show

Mostrar detalles de un esquema dentro de un registro de esquema.

Extensión Vista previa
az iot ops schema show-dataflow-refs

Mostrar las referencias de esquema usadas para los flujos de datos.

Extensión Experimental
az iot ops schema version

Administración de versiones de esquema.

Extensión Vista previa
az iot ops schema version add

Agregue una versión de esquema a un esquema.

Extensión Vista previa
az iot ops schema version list

Enumerar las versiones de esquema para un esquema específico.

Extensión Vista previa
az iot ops schema version remove

Quite una versión de esquema de destino.

Extensión Vista previa
az iot ops schema version show

Mostrar detalles de una versión de esquema.

Extensión Vista previa
az iot ops secretsync

Administración de sincronización de secretos de instancia.

Extensión Vista previa
az iot ops secretsync disable

Deshabilite la sincronización de secretos para una instancia.

Extensión Vista previa
az iot ops secretsync enable

Habilite la sincronización de secretos para una instancia.

Extensión Vista previa
az iot ops secretsync list

Enumere las configuraciones de sincronización de secretos asociadas a una instancia.

Extensión Vista previa
az iot ops show

Mostrar una instancia de operaciones de IoT.

Extensión GA
az iot ops support

Operaciones de IoT admiten operaciones.

Extensión Vista previa
az iot ops support create-bundle

Crea un archivo zip de agrupación de compatibilidad estándar para su uso en la solución de problemas y diagnósticos.

Extensión Vista previa
az iot ops update

Actualice una instancia de operaciones de IoT.

Extensión GA
az iot ops upgrade

Actualice una instancia de IoT Operations a la versión más reciente.

Extensión Obsolescente

az iot ops check

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

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.

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

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura.

Actualice una instancia de IoT Operations a la versión más reciente.

ADVERTENCIA: Este comando puede producir un error y requerir que elimine y vuelva a crear el clúster y la instancia.

Actualice una instancia de IoT Operations, incluida la actualización de las extensiones a las versiones más recientes. Use este comando si az iot ops show se producen errores o comandos similares.

El identificador de recurso del Registro de esquema es un parámetro opcional y puede ser necesario en escenarios específicos.

az iot ops upgrade --name
                   --resource-group
                   [--no-progress {false, true}]
                   [--sr-resource-id]
                   [--yes {false, true}]

Ejemplos

Actualice la instancia con entradas mínimas.

az iot ops upgrade --name myinstance -g myresourcegroup

Omita el símbolo del sistema de conformación durante la actualización de la instancia.

az iot ops upgrade --name myinstance -g myresourcegroup -y

Actualice la instancia y especifique el identificador de recurso del Registro de esquema.

az iot ops upgrade --name myinstance -g myresourcegroup --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID

Parámetros requeridos

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

--no-progress

Deshabilite la representación visual del trabajo.

Valores aceptados: false, true
--sr-resource-id

Identificador de recurso del Registro de esquema que se va a usar con operaciones de IoT. Obligatorio si el identificador de recurso del Registro de esquema ya no se encuentra en operaciones de IoT.

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