Compartir a través de

az iot ops dataflow endpoint update

Note

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

Actualice las propiedades de un recurso de punto de conexión de flujo de datos existente.

Comandos

Nombre Description Tipo Estado
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.

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

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

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

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

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

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

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

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

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

 Extension GA
az iot ops dataflow endpoint update otel

Actualice las propiedades de un punto de conexión de flujo de datos openTelemetry existente.

 Extension GA

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.

Para más información sobre el punto de conexión de flujo de datos de Azure Data Lake Storage Gen2, consulte https://aka.ms/adlsv2.

az iot ops dataflow endpoint update adls --instance
                                         --name
                                         --resource-group
                                         [--aud --audience]
                                         [--auth-type {AccessToken, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                         [--cid --client-id]
                                         [--latency]
                                         [--mc --message-count]
                                         [--sa --storage-account]
                                         [--scope]
                                         [--secret-name]
                                         [--show-config {false, true}]
                                         [--tenant-id --tid]

Ejemplos

Actualice el nombre de la cuenta de almacenamiento del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update adls --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --storage-account newstorageaccount

Actualice para usar el método de autenticación de identidad administrada asignada por el usuario del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update adls --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --client-id 425cb1e9-1247-4cbc-8cdb-1aac9b429696 --tenant-id bca45660-49a2-4bad-862a-0b9459b4b836 --scope "https://storage.azure.com/.default"

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

Nombre del punto de conexión de flujo de datos.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--aud --audience

Audiencia del servicio en la que se va a autenticar.

Propiedad Valor
Grupo de parámetros: System Assigned Managed Identity Arguments
--auth-type

Tipo de autenticación para el punto de conexión de flujo de datos. Nota: Cuando no se especifica, el tipo de autenticación se determina por otros parámetros de autenticación.

Propiedad Valor
Valores aceptados: AccessToken, SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cid --client-id

Identificador de cliente de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--latency -l

Latencia de procesamiento por lotes en milisegundos. Valor mínimo: 0, valor máximo: 65535.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--mc --message-count

Número máximo de mensajes en un lote. Valor mínimo: 0, valor máximo: 4294967295.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--sa --storage-account

Nombre de la cuenta de Azure Data Lake Storage Gen2.

--scope

Identificador de recurso (URI de identificador de aplicación) del recurso, con el sufijo .default.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--secret-name -s

Nombre del secreto de Kubernetes que contiene el token de SAS.

Propiedad Valor
Grupo de parámetros: Access Token Arguments
--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad Valor
Valores aceptados: false, true
--tenant-id --tid

Identificador de inquilino de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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.

Para más información sobre el punto de conexión de flujo de datos de Azure Data Explorer, consulte https://aka.ms/aio-adx.

az iot ops dataflow endpoint update adx --instance
                                        --name
                                        --resource-group
                                        [--aud --audience]
                                        [--auth-type {SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                        [--cid --client-id]
                                        [--database --db]
                                        [--host]
                                        [--latency]
                                        [--mc --message-count]
                                        [--scope]
                                        [--show-config {false, true}]
                                        [--tenant-id --tid]

Ejemplos

Actualice las configuraciones de procesamiento por lotes del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update adx --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --latency 70 --message-count 100

Actualice para usar el método de autenticación de identidad administrada asignada por el sistema del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update adx --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --auth-type SystemAssignedManagedIdentity

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

Nombre del punto de conexión de flujo de datos.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--aud --audience

Audiencia del servicio en la que se va a autenticar.

Propiedad Valor
Grupo de parámetros: System Assigned Managed Identity Arguments
--auth-type

Tipo de autenticación para el punto de conexión de flujo de datos. Nota: Cuando no se especifica, el tipo de autenticación se determina por otros parámetros de autenticación.

Propiedad Valor
Valores aceptados: SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cid --client-id

Identificador de cliente de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--database --db

Nombre de la base de datos de Azure Data Explorer.

--host

El host de Azure Data Explorer es el URI del clúster de Azure Data Explorer. En forma de https://cluster.region.kusto.windows.net.

--latency -l

Latencia de procesamiento por lotes en milisegundos. Valor mínimo: 0, valor máximo: 65535.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--mc --message-count

Número máximo de mensajes en un lote. Valor mínimo: 0, valor máximo: 4294967295.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--scope

Identificador de recurso (URI de identificador de aplicación) del recurso, con el sufijo .default.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad Valor
Valores aceptados: false, true
--tenant-id --tid

Identificador de inquilino de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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.

Para obtener más información sobre el punto de conexión de flujo de datos de kafka personalizado, consulte https://aka.ms/aio-custom-kafka.

az iot ops dataflow endpoint update custom-kafka --instance
                                                 --name
                                                 --resource-group
                                                 [--acks {All, One, Zero}]
                                                 [--aud --audience]
                                                 [--auth-type {Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                                 [--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
                                                 [--cid --client-id]
                                                 [--cm --config-map-ref]
                                                 [--compression {Gzip, Lz4, None, Snappy}]
                                                 [--db --disable-batching {false, true}]
                                                 [--dbpc --disable-broker-props-copy {false, true}]
                                                 [--disable-tls {false, true}]
                                                 [--gid --group-id]
                                                 [--hostname]
                                                 [--latency]
                                                 [--max-bytes --mb]
                                                 [--mc --message-count]
                                                 [--no-auth {false, true}]
                                                 [--partition-strategy --ps {Default, Property, Static, Topic}]
                                                 [--port]
                                                 [--sasl-type {Plain, ScramSha256, ScramSha512}]
                                                 [--scope]
                                                 [--secret-name]
                                                 [--show-config {false, true}]
                                                 [--tenant-id --tid]

Ejemplos

Actualice el nombre de host del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update custom-kafka --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname newkafkabroker

Actualice para usar el método de autenticación SASL del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update custom-kafka --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --sasl-type ScramSha256 --secret-name mysecret

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

Nombre del punto de conexión de flujo de datos.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acks

Nivel de confirmación del agente de Kafka para asegurarse de que el mensaje enviado por productor se escribe correctamente en el tema y se replica en el clúster de Kafka.

Propiedad Valor
Valor predeterminado: All
Valores aceptados: All, One, Zero
--aud --audience

Audiencia del servicio en la que se va a autenticar.

Propiedad Valor
Grupo de parámetros: System Assigned Managed Identity Arguments
--auth-type

Tipo de autenticación para el punto de conexión de flujo de datos. Nota: Cuando no se especifica, el tipo de autenticación se determina por otros parámetros de autenticación.

Propiedad Valor
Valores aceptados: Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cea --cloud-event-attribute

Tipo de configuración de CloudEvent para asignar eventos a la nube. Se requiere un formato de mensaje diferente mediante una configuración diferente.

Propiedad Valor
Grupo de parámetros: Cloud Event Arguments
Valor predeterminado: Propagate
Valores aceptados: CreateOrRemap, Propagate
--cid --client-id

Identificador de cliente de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--cm --config-map-ref

Referencia de mapa de configuración para el certificado de ENTIDAD de certificación de confianza para el punto de conexión de Kafka/MQTT. Nota: Este configMap debe contener el certificado de ENTIDAD de certificación en formato PEM. ConfigMap debe estar en el mismo espacio de nombres que el recurso de flujo de datos Kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
--compression

Tipo de compresión para los mensajes enviados a temas de Kafka.

Propiedad Valor
Valor predeterminado: None
Valores aceptados: Gzip, Lz4, None, Snappy
--db --disable-batching

Deshabilite el procesamiento por lotes.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
Valores aceptados: false, true
--dbpc --disable-broker-props-copy

Deshabilite la copia de las propiedades del agente MQTT en los encabezados de usuario de Kafka.

Propiedad Valor
Valores aceptados: false, true
--disable-tls

El flujo de datos usa una conexión no segura al agente kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
Valores aceptados: false, true
--gid --group-id

Identificador del grupo de consumidores que usa el flujo de datos para leer mensajes del tema de Kafka.

--hostname

Nombre de host de la configuración del host del agente de Kafka.

--latency -l

Latencia de procesamiento por lotes en milisegundos. Valor mínimo: 0, valor máximo: 65535.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--max-bytes --mb

Número máximo de bytes en un lote.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--mc --message-count

Número máximo de mensajes en un lote. Valor mínimo: 0, valor máximo: 4294967295.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--no-auth

No hay autenticación para el punto de conexión.

Propiedad Valor
Valores aceptados: false, true
--partition-strategy --ps

La estrategia de control de particiones controla cómo se asignan los mensajes a las particiones de Kafka al enviarlos a temas de Kafka.

Propiedad Valor
Valor predeterminado: Default
Valores aceptados: Default, Property, Static, Topic
--port

Número de puerto de la configuración del host del agente de Kafka.

--sasl-type

El tipo de autenticación SASL.

Propiedad Valor
Grupo de parámetros: SASL Authentication Arguments
Valores aceptados: Plain, ScramSha256, ScramSha512
--scope

Identificador de recurso (URI de identificador de aplicación) del recurso, con el sufijo .default.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--secret-name -s

Nombre del secreto de Kubernetes que contiene las el token de SASL.

Propiedad Valor
Grupo de parámetros: SASL Authentication Arguments
--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad Valor
Valores aceptados: false, true
--tenant-id --tid

Identificador de inquilino de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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.

Para obtener más información sobre el punto de conexión de flujo de datos MQTT personalizado, consulte https://aka.ms/aio-custom-mqtt.

az iot ops dataflow endpoint update custom-mqtt --instance
                                                --name
                                                --resource-group
                                                [--auth-type {ServiceAccountToken, SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate}]
                                                [--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
                                                [--cid --client-id]
                                                [--client-id-prefix]
                                                [--cm --config-map-ref]
                                                [--disable-tls {false, true}]
                                                [--hostname]
                                                [--ka --keep-alive]
                                                [--max-inflight-msg --mim]
                                                [--no-auth {false, true}]
                                                [--port]
                                                [--protocol {Mqtt, WebSockets}]
                                                [--qos]
                                                [--retain {Keep, Never}]
                                                [--sami-aud --sami-audience]
                                                [--sat-aud --sat-audience]
                                                [--scope]
                                                [--secret-name]
                                                [--session-expiry]
                                                [--show-config {false, true}]
                                                [--tenant-id --tid]

Ejemplos

Actualice el tipo de configuración de eventos en la nube del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update custom-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --cloud-event-attribute CreateOrRemap

Actualice para usar el método de autenticación X509 del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update custom-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --auth-type X509Certificate --secret-name mysecret

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

Nombre del punto de conexión de flujo de datos.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--auth-type

Tipo de autenticación para el punto de conexión de flujo de datos. Nota: Cuando no se especifica, el tipo de autenticación se determina por otros parámetros de autenticación.

Propiedad Valor
Valores aceptados: ServiceAccountToken, SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate
--cea --cloud-event-attribute

Tipo de configuración de CloudEvent para asignar eventos a la nube. Se requiere un formato de mensaje diferente mediante una configuración diferente.

Propiedad Valor
Grupo de parámetros: Cloud Event Arguments
Valor predeterminado: Propagate
Valores aceptados: CreateOrRemap, Propagate
--cid --client-id

Identificador de cliente de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--client-id-prefix

Prefijo de identificador de cliente para el cliente MQTT. Nota: Cambiar el prefijo de identificador de cliente después de la implementación de operaciones de IoT podría provocar la pérdida de datos.

--cm --config-map-ref

Referencia de mapa de configuración para el certificado de ENTIDAD de certificación de confianza para el punto de conexión de Kafka/MQTT. Nota: Este configMap debe contener el certificado de ENTIDAD de certificación en formato PEM. ConfigMap debe estar en el mismo espacio de nombres que el recurso de flujo de datos Kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
--disable-tls

El flujo de datos usa una conexión no segura al agente kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
Valores aceptados: false, true
--hostname

Nombre de host de la configuración personalizada del host del agente MQTT.

--ka --keep-alive

Tiempo máximo en segundos que el cliente de flujo de datos puede estar inactivo antes de enviar un mensaje PINGREQ al agente. Valor mínimo: 0.

--max-inflight-msg --mim

Número máximo de mensajes en curso que puede tener el cliente MQTT del flujo de datos. Valor mínimo: 0.

--no-auth

No hay autenticación para el punto de conexión.

Propiedad Valor
Valores aceptados: false, true
--port

Número de puerto de la configuración personalizada del host del agente MQTT.

--protocol

Protocolo que se va a usar para las conexiones de cliente.

Propiedad Valor
Valor predeterminado: Mqtt
Valores aceptados: Mqtt, WebSockets
--qos

Nivel de calidad de servicio (QoS) para los mensajes MQTT. Solo se admiten 0 o 1.

--retain

Mantenga la configuración para especificar si el flujo de datos debe mantener la marca de retención en los mensajes MQTT. Establecer esto garantiza si el agente remoto tiene o no los mismos mensajes retenidos que el agente local.

Propiedad Valor
Valor predeterminado: Keep
Valores aceptados: Keep, Never
--sami-aud --sami-audience

Audiencia de la identidad administrada asignada por el sistema.

Propiedad Valor
Grupo de parámetros: System Assigned Managed Identity Arguments
--sat-aud --sat-audience

Audiencia del token de cuenta de servicio de Kubernetes (SAT).

Propiedad Valor
Grupo de parámetros: Kubernetes Service Account Token Arguments
--scope

Identificador de recurso (URI de identificador de aplicación) del recurso, con el sufijo .default.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--secret-name -s

El nombre del secreto de Kubernetes que contiene el certificado de cliente X509, la clave privada correspondiente al certificado de cliente y los certificados intermedios para la cadena de certificados de cliente. Nota: El certificado y la clave privada deben estar en formato PEM y no estar protegidos con contraseña.

Propiedad Valor
Grupo de parámetros: X509 Authentication Arguments
--session-expiry

Intervalo de expiración de la sesión en segundos para el cliente MQTT del flujo de datos. Valor mínimo: 0.

--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad Valor
Valores aceptados: false, true
--tenant-id --tid

Identificador de inquilino de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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.

Para más información sobre el punto de conexión de flujo de datos de Azure Event Grid, consulte https://aka.ms/aio-eventgrid.

az iot ops dataflow endpoint update eventgrid --instance
                                              --name
                                              --resource-group
                                              [--aud --audience]
                                              [--auth-type {SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate}]
                                              [--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
                                              [--cid --client-id]
                                              [--client-id-prefix]
                                              [--cm --config-map-ref]
                                              [--hostname]
                                              [--ka --keep-alive]
                                              [--max-inflight-msg --mim]
                                              [--port]
                                              [--protocol {Mqtt, WebSockets}]
                                              [--qos]
                                              [--retain {Keep, Never}]
                                              [--scope]
                                              [--secret-name]
                                              [--session-expiry]
                                              [--show-config {false, true}]
                                              [--tenant-id --tid]

Ejemplos

Actualice el intervalo de expiración de la sesión del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update eventgrid --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --session-expiry 100

Actualice para usar el método de autenticación X509 del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update eventgrid --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --secret-name mysecret

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

Nombre del punto de conexión de flujo de datos.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--aud --audience

Audiencia del servicio en la que se va a autenticar.

Propiedad Valor
Grupo de parámetros: System Assigned Managed Identity Arguments
--auth-type

Tipo de autenticación para el punto de conexión de flujo de datos. Nota: Cuando no se especifica, el tipo de autenticación se determina por otros parámetros de autenticación.

Propiedad Valor
Valores aceptados: SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate
--cea --cloud-event-attribute

Tipo de configuración de CloudEvent para asignar eventos a la nube. Se requiere un formato de mensaje diferente mediante una configuración diferente.

Propiedad Valor
Grupo de parámetros: Cloud Event Arguments
Valor predeterminado: Propagate
Valores aceptados: CreateOrRemap, Propagate
--cid --client-id

Identificador de cliente de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--client-id-prefix

Prefijo de identificador de cliente para el cliente MQTT. Nota: Cambiar el prefijo de identificador de cliente después de la implementación de operaciones de IoT podría provocar la pérdida de datos.

--cm --config-map-ref

Referencia de mapa de configuración para el certificado de ENTIDAD de certificación de confianza para el punto de conexión de Kafka/MQTT. Nota: Este configMap debe contener el certificado de ENTIDAD de certificación en formato PEM. ConfigMap debe estar en el mismo espacio de nombres que el recurso de flujo de datos Kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
--hostname

Nombre de host del espacio de nombres de Event Grid. Se puede encontrar en la propiedad "Http hostname". En forma de NAMESPACE.REGION-1.ts.eventgrid.azure.net.

--ka --keep-alive

Tiempo máximo en segundos que el cliente de flujo de datos puede estar inactivo antes de enviar un mensaje PINGREQ al agente. Valor mínimo: 0.

--max-inflight-msg --mim

Número máximo de mensajes en curso que puede tener el cliente MQTT del flujo de datos. Valor mínimo: 0.

--port

Número de puerto del espacio de nombres de Event Grid.

--protocol

Protocolo que se va a usar para las conexiones de cliente.

Propiedad Valor
Valor predeterminado: Mqtt
Valores aceptados: Mqtt, WebSockets
--qos

Nivel de calidad de servicio (QoS) para los mensajes MQTT. Solo se admiten 0 o 1.

--retain

Mantenga la configuración para especificar si el flujo de datos debe mantener la marca de retención en los mensajes MQTT. Establecer esto garantiza si el agente remoto tiene o no los mismos mensajes retenidos que el agente local.

Propiedad Valor
Valor predeterminado: Keep
Valores aceptados: Keep, Never
--scope

Identificador de recurso (URI de identificador de aplicación) del recurso, con el sufijo .default.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--secret-name -s

El nombre del secreto de Kubernetes que contiene el certificado de cliente X509, la clave privada correspondiente al certificado de cliente y los certificados intermedios para la cadena de certificados de cliente. Nota: El certificado y la clave privada deben estar en formato PEM y no estar protegidos con contraseña.

Propiedad Valor
Grupo de parámetros: X509 Authentication Arguments
--session-expiry

Intervalo de expiración de la sesión en segundos para el cliente MQTT del flujo de datos. Valor mínimo: 0.

--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad Valor
Valores aceptados: false, true
--tenant-id --tid

Identificador de inquilino de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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.

Para más información sobre el punto de conexión de flujo de datos de Azure Event Hubs, consulte https://aka.ms/aio-eventhub.

az iot ops dataflow endpoint update eventhub --instance
                                             --name
                                             --resource-group
                                             [--acks {All, One, Zero}]
                                             [--aud --audience]
                                             [--auth-type {Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                             [--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
                                             [--cid --client-id]
                                             [--cm --config-map-ref]
                                             [--compression {Gzip, Lz4, None, Snappy}]
                                             [--db --disable-batching {false, true}]
                                             [--dbpc --disable-broker-props-copy {false, true}]
                                             [--ehns --eventhub-namespace]
                                             [--gid --group-id]
                                             [--latency]
                                             [--max-bytes --mb]
                                             [--mc --message-count]
                                             [--partition-strategy --ps {Default, Property, Static, Topic}]
                                             [--sasl-type {Plain, ScramSha256, ScramSha512}]
                                             [--scope]
                                             [--secret-name]
                                             [--show-config {false, true}]
                                             [--tenant-id --tid]

Ejemplos

Actualice el tipo de compresión del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update eventhub --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --compression Gzip

Actualice para usar el método de autenticación SASL del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update eventhub --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --sasl-type ScramSha256 --secret-name mysecret

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

Nombre del punto de conexión de flujo de datos.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acks

Nivel de confirmación del agente de Kafka para asegurarse de que el mensaje enviado por productor se escribe correctamente en el tema y se replica en el clúster de Kafka.

Propiedad Valor
Valor predeterminado: All
Valores aceptados: All, One, Zero
--aud --audience

Audiencia del servicio en la que se va a autenticar.

Propiedad Valor
Grupo de parámetros: System Assigned Managed Identity Arguments
--auth-type

Tipo de autenticación para el punto de conexión de flujo de datos. Nota: Cuando no se especifica, el tipo de autenticación se determina por otros parámetros de autenticación.

Propiedad Valor
Valores aceptados: Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cea --cloud-event-attribute

Tipo de configuración de CloudEvent para asignar eventos a la nube. Se requiere un formato de mensaje diferente mediante una configuración diferente.

Propiedad Valor
Grupo de parámetros: Cloud Event Arguments
Valor predeterminado: Propagate
Valores aceptados: CreateOrRemap, Propagate
--cid --client-id

Identificador de cliente de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--cm --config-map-ref

Referencia de mapa de configuración para el certificado de ENTIDAD de certificación de confianza para el punto de conexión de Kafka/MQTT. Nota: Este configMap debe contener el certificado de ENTIDAD de certificación en formato PEM. ConfigMap debe estar en el mismo espacio de nombres que el recurso de flujo de datos Kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
--compression

Tipo de compresión para los mensajes enviados a temas de Kafka.

Propiedad Valor
Valor predeterminado: None
Valores aceptados: Gzip, Lz4, None, Snappy
--db --disable-batching

Deshabilite el procesamiento por lotes.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
Valores aceptados: false, true
--dbpc --disable-broker-props-copy

Deshabilite la copia de las propiedades del agente MQTT en los encabezados de usuario de Kafka.

Propiedad Valor
Valores aceptados: false, true
--ehns --eventhub-namespace

Nombre del espacio de nombres de Event Hubs.

--gid --group-id

Identificador del grupo de consumidores que usa el flujo de datos para leer mensajes del tema de Kafka.

--latency -l

Latencia de procesamiento por lotes en milisegundos. Valor mínimo: 0, valor máximo: 65535.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--max-bytes --mb

Número máximo de bytes en un lote.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--mc --message-count

Número máximo de mensajes en un lote. Valor mínimo: 0, valor máximo: 4294967295.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--partition-strategy --ps

La estrategia de control de particiones controla cómo se asignan los mensajes a las particiones de Kafka al enviarlos a temas de Kafka.

Propiedad Valor
Valor predeterminado: Default
Valores aceptados: Default, Property, Static, Topic
--sasl-type

El tipo de autenticación SASL.

Propiedad Valor
Grupo de parámetros: SASL Authentication Arguments
Valores aceptados: Plain, ScramSha256, ScramSha512
--scope

Identificador de recurso (URI de identificador de aplicación) del recurso, con el sufijo .default.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--secret-name -s

Nombre del secreto de Kubernetes que contiene la cadena de conexión del centro de eventos. Nota: El secreto debe estar en el mismo espacio de nombres que el punto de conexión de flujo de datos de Kafka. El secreto debe tener el nombre de usuario y la contraseña como pares clave-valor. Para obtener más información sobre el formato de secreto, consulte el vínculo en la descripción del comando.

Propiedad Valor
Grupo de parámetros: SASL Authentication Arguments
--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad Valor
Valores aceptados: false, true
--tenant-id --tid

Identificador de inquilino de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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.

Para obtener más información sobre el punto de conexión de flujo de datos oneLake de Microsoft Fabric, consulte https://aka.ms/fabric-onelake.

az iot ops dataflow endpoint update fabric-onelake --instance
                                                   --name
                                                   --resource-group
                                                   [--aud --audience]
                                                   [--auth-type {SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                                   [--cid --client-id]
                                                   [--lakehouse]
                                                   [--latency]
                                                   [--mc --message-count]
                                                   [--path-type --pt {Files, Tables}]
                                                   [--scope]
                                                   [--show-config {false, true}]
                                                   [--tenant-id --tid]
                                                   [--workspace]

Ejemplos

Actualice el nombre de lakehouse del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update fabric-onelake --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --lakehouse newlakehouse

Actualice para usar el método de autenticación de identidad administrada asignada por el sistema del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update fabric-onelake --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --audience newaudience

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

Nombre del punto de conexión de flujo de datos.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--aud --audience

Audiencia del servicio en la que se va a autenticar.

Propiedad Valor
Grupo de parámetros: System Assigned Managed Identity Arguments
--auth-type

Tipo de autenticación para el punto de conexión de flujo de datos. Nota: Cuando no se especifica, el tipo de autenticación se determina por otros parámetros de autenticación.

Propiedad Valor
Valores aceptados: SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cid --client-id

Identificador de cliente de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--lakehouse

Nombre del lago de Microsoft Fabric en el área de trabajo proporcionada.

--latency -l

Latencia de procesamiento por lotes en milisegundos. Valor mínimo: 0, valor máximo: 65535.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--mc --message-count

Número máximo de mensajes en un lote. Valor mínimo: 0, valor máximo: 4294967295.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--path-type --pt

Tipo de ruta de acceso usada en OneLake.

Propiedad Valor
Valores aceptados: Files, Tables
--scope

Identificador de recurso (URI de identificador de aplicación) del recurso, con el sufijo .default.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad Valor
Valores aceptados: false, true
--tenant-id --tid

Identificador de inquilino de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--workspace

Nombre del área de trabajo de Microsoft Fabric. Nota: No se admite el valor predeterminado "mi área de trabajo".

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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.

Para obtener más información sobre el punto de conexión de flujo de datos de Inteligencia de Microsoft Fabric Real-Time, consulte https://aka.ms/aio-fabric-real-time.

az iot ops dataflow endpoint update fabric-realtime --instance
                                                    --name
                                                    --resource-group
                                                    [--acks {All, One, Zero}]
                                                    [--aud --audience]
                                                    [--auth-type {Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                                    [--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
                                                    [--cid --client-id]
                                                    [--cm --config-map-ref]
                                                    [--compression {Gzip, Lz4, None, Snappy}]
                                                    [--db --disable-batching {false, true}]
                                                    [--dbpc --disable-broker-props-copy {false, true}]
                                                    [--disable-tls {false, true}]
                                                    [--gid --group-id]
                                                    [--host]
                                                    [--latency]
                                                    [--max-bytes --mb]
                                                    [--mc --message-count]
                                                    [--partition-strategy --ps {Default, Property, Static, Topic}]
                                                    [--sasl-type {Plain, ScramSha256, ScramSha512}]
                                                    [--scope]
                                                    [--secret-name]
                                                    [--show-config {false, true}]
                                                    [--tenant-id --tid]

Ejemplos

Actualice la estrategia de partición del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update fabric-realtime --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --partition-strategy Static

Actualice para usar el método de autenticación SASL del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update fabric-realtime --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --sasl-type ScramSha256 --secret-name mysecret

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

Nombre del punto de conexión de flujo de datos.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acks

Nivel de confirmación del agente de Kafka para asegurarse de que el mensaje enviado por productor se escribe correctamente en el tema y se replica en el clúster de Kafka.

Propiedad Valor
Valor predeterminado: All
Valores aceptados: All, One, Zero
--aud --audience

Audiencia del servicio en la que se va a autenticar.

Propiedad Valor
Grupo de parámetros: System Assigned Managed Identity Arguments
--auth-type

Tipo de autenticación para el punto de conexión de flujo de datos. Nota: Cuando no se especifica, el tipo de autenticación se determina por otros parámetros de autenticación.

Propiedad Valor
Valores aceptados: Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cea --cloud-event-attribute

Tipo de configuración de CloudEvent para asignar eventos a la nube. Se requiere un formato de mensaje diferente mediante una configuración diferente.

Propiedad Valor
Grupo de parámetros: Cloud Event Arguments
Valor predeterminado: Propagate
Valores aceptados: CreateOrRemap, Propagate
--cid --client-id

Identificador de cliente de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--cm --config-map-ref

Referencia de mapa de configuración para el certificado de ENTIDAD de certificación de confianza para el punto de conexión de Kafka/MQTT. Nota: Este configMap debe contener el certificado de ENTIDAD de certificación en formato PEM. ConfigMap debe estar en el mismo espacio de nombres que el recurso de flujo de datos Kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
--compression

Tipo de compresión para los mensajes enviados a temas de Kafka.

Propiedad Valor
Valor predeterminado: None
Valores aceptados: Gzip, Lz4, None, Snappy
--db --disable-batching

Deshabilite el procesamiento por lotes.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
Valores aceptados: false, true
--dbpc --disable-broker-props-copy

Deshabilite la copia de las propiedades del agente MQTT en los encabezados de usuario de Kafka.

Propiedad Valor
Valores aceptados: false, true
--disable-tls

El flujo de datos usa una conexión no segura al agente kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
Valores aceptados: false, true
--gid --group-id

Identificador del grupo de consumidores que usa el flujo de datos para leer mensajes del tema de Kafka.

--host

El host del tejido en tiempo real es el valor "Servidor de arranque". Puede encontrarse en el destino del flujo de eventos: sección "Autenticación de clave SAS". En forma de *.servicebus.windows.net:9093.

--latency -l

Latencia de procesamiento por lotes en milisegundos. Valor mínimo: 0, valor máximo: 65535.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--max-bytes --mb

Número máximo de bytes en un lote.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--mc --message-count

Número máximo de mensajes en un lote. Valor mínimo: 0, valor máximo: 4294967295.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--partition-strategy --ps

La estrategia de control de particiones controla cómo se asignan los mensajes a las particiones de Kafka al enviarlos a temas de Kafka.

Propiedad Valor
Valor predeterminado: Default
Valores aceptados: Default, Property, Static, Topic
--sasl-type

El tipo de autenticación SASL.

Propiedad Valor
Grupo de parámetros: SASL Authentication Arguments
Valores aceptados: Plain, ScramSha256, ScramSha512
--scope

Identificador de recurso (URI de identificador de aplicación) del recurso, con el sufijo .default.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
--secret-name -s

Nombre del secreto de Kubernetes que contiene el valor de clave principal de la cadena de conexión. Puede encontrarse en el destino del flujo de eventos: sección "Autenticación de clave SAS". Nota: El secreto debe estar en el mismo espacio de nombres que el punto de conexión de flujo de datos de Kafka. Para obtener más información sobre el formato de secreto, consulte el vínculo en la descripción del comando.

Propiedad Valor
Grupo de parámetros: SASL Authentication Arguments
--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad Valor
Valores aceptados: false, true
--tenant-id --tid

Identificador de inquilino de la identidad asignada por el usuario.

Propiedad Valor
Grupo de parámetros: User Assigned Managed Identity Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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.

Para más información sobre el punto de conexión de flujo de datos MQTT local de Azure IoT Operations, consulte https://aka.ms/local-mqtt-broker.

az iot ops dataflow endpoint update local-mqtt --instance
                                               --name
                                               --resource-group
                                               [--aud --audience]
                                               [--auth-type {ServiceAccountToken, X509Certificate}]
                                               [--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
                                               [--client-id-prefix]
                                               [--cm --config-map-ref]
                                               [--disable-tls {false, true}]
                                               [--hostname]
                                               [--ka --keep-alive]
                                               [--max-inflight-msg --mim]
                                               [--no-auth {false, true}]
                                               [--port]
                                               [--protocol {Mqtt, WebSockets}]
                                               [--qos]
                                               [--retain {Keep, Never}]
                                               [--secret-name]
                                               [--session-expiry]
                                               [--show-config {false, true}]

Ejemplos

Actualice la referencia de mapa de configuración para el certificado de entidad de certificación de confianza del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update local-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --config-map-ref mynewconfigmap

Actualice para usar el método de autenticación de token de cuenta de servicio de Kubernetes del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update local-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --auth-type ServiceAccountToken --audience myaudience

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

Nombre del punto de conexión de flujo de datos.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--aud --audience

Audiencia del token de cuenta de servicio de Kubernetes (SAT).

Propiedad Valor
Grupo de parámetros: Kubernetes Service Account Token Arguments
--auth-type

Tipo de autenticación para el punto de conexión de flujo de datos. Nota: Cuando no se especifica, el tipo de autenticación se determina por otros parámetros de autenticación.

Propiedad Valor
Valores aceptados: ServiceAccountToken, X509Certificate
--cea --cloud-event-attribute

Tipo de configuración de CloudEvent para asignar eventos a la nube. Se requiere un formato de mensaje diferente mediante una configuración diferente.

Propiedad Valor
Grupo de parámetros: Cloud Event Arguments
Valor predeterminado: Propagate
Valores aceptados: CreateOrRemap, Propagate
--client-id-prefix

Prefijo de identificador de cliente para el cliente MQTT. Nota: Cambiar el prefijo de identificador de cliente después de la implementación de operaciones de IoT podría provocar la pérdida de datos.

--cm --config-map-ref

Referencia de mapa de configuración para el certificado de ENTIDAD de certificación de confianza para el punto de conexión de Kafka/MQTT. Nota: Este configMap debe contener el certificado de ENTIDAD de certificación en formato PEM. ConfigMap debe estar en el mismo espacio de nombres que el recurso de flujo de datos Kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
--disable-tls

El flujo de datos usa una conexión no segura al agente kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
Valor predeterminado: False
Valores aceptados: false, true
--hostname

Nombre de host del agente MQTT local.

--ka --keep-alive

Tiempo máximo en segundos que el cliente de flujo de datos puede estar inactivo antes de enviar un mensaje PINGREQ al agente. Valor mínimo: 0.

--max-inflight-msg --mim

Número máximo de mensajes en curso que puede tener el cliente MQTT del flujo de datos. Valor mínimo: 0.

--no-auth

No hay autenticación para el punto de conexión.

Propiedad Valor
Valores aceptados: false, true
--port

Número de puerto del agente MQTT local.

--protocol

Protocolo que se va a usar para las conexiones de cliente.

Propiedad Valor
Valor predeterminado: Mqtt
Valores aceptados: Mqtt, WebSockets
--qos

Nivel de calidad de servicio (QoS) para los mensajes MQTT. Solo se admiten 0 o 1.

--retain

Mantenga la configuración para especificar si el flujo de datos debe mantener la marca de retención en los mensajes MQTT. Establecer esto garantiza si el agente remoto tiene o no los mismos mensajes retenidos que el agente local.

Propiedad Valor
Valor predeterminado: Keep
Valores aceptados: Keep, Never
--secret-name -s

El nombre del secreto de Kubernetes que contiene el certificado de cliente X509, la clave privada correspondiente al certificado de cliente y los certificados intermedios para la cadena de certificados de cliente. Nota: El certificado y la clave privada deben estar en formato PEM y no estar protegidos con contraseña.

Propiedad Valor
Grupo de parámetros: X509 Authentication Arguments
--session-expiry

Intervalo de expiración de la sesión en segundos para el cliente MQTT del flujo de datos. Valor mínimo: 0.

--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad Valor
Valores aceptados: false, true
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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.

Para obtener más información sobre el punto de conexión de flujo de datos de almacenamiento local, consulte https://aka.ms/local-storage-endpoint.

az iot ops dataflow endpoint update local-storage --instance
                                                  --name
                                                  --resource-group
                                                  [--pvc-ref]
                                                  [--show-config {false, true}]

Ejemplos

Actualice la referencia de PVC del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update local-storage --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --pvc-ref newpvc

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

Nombre del punto de conexión de flujo de datos.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--pvc-ref

Nombre de PersistentVolumeClaim (PVC) que se va a usar para el almacenamiento local. Nota: La PVC debe estar en el mismo espacio de nombres que el punto de conexión del flujo de datos.

--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad Valor
Valores aceptados: false, true
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot ops dataflow endpoint update otel

Actualice las propiedades de un punto de conexión de flujo de datos openTelemetry existente.

Para obtener más información sobre el punto de conexión de flujo de datos openTelemetry, consulte https://aka.ms/opentelemetry-endpoint.

az iot ops dataflow endpoint update otel --instance
                                         --name
                                         --resource-group
                                         [--aud --audience]
                                         [--auth-type {ServiceAccountToken, X509Certificate}]
                                         [--cm --config-map-ref]
                                         [--disable-tls {false, true}]
                                         [--hostname]
                                         [--latency]
                                         [--mc --message-count]
                                         [--no-auth {false, true}]
                                         [--port]
                                         [--secret-name]
                                         [--show-config {false, true}]

Ejemplos

Actualice la referencia de mapa de configuración para el certificado de entidad de certificación de confianza del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update otel --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --config-map-ref mynewconfigmap

Actualice para usar el método de autenticación de token de cuenta de servicio de Kubernetes del recurso de punto de conexión de flujo de datos denominado "myendpoint".

az iot ops dataflow endpoint update otel --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --auth-type ServiceAccountToken --audience myaudience

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

Nombre del punto de conexión de flujo de datos.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--aud --audience

Audiencia del servicio en la que se va a autenticar.

Propiedad Valor
Grupo de parámetros: System Assigned Managed Identity Arguments
--auth-type

Tipo de autenticación para el punto de conexión de flujo de datos. Nota: Cuando no se especifica, el tipo de autenticación se determina por otros parámetros de autenticación.

Propiedad Valor
Valores aceptados: ServiceAccountToken, X509Certificate
--cm --config-map-ref

Referencia de mapa de configuración para el certificado de ENTIDAD de certificación de confianza para el punto de conexión de Kafka/MQTT. Nota: Este configMap debe contener el certificado de ENTIDAD de certificación en formato PEM. ConfigMap debe estar en el mismo espacio de nombres que el recurso de flujo de datos Kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
--disable-tls

El flujo de datos usa una conexión no segura al agente kafka/MQTT.

Propiedad Valor
Grupo de parámetros: Transport Layer Security (TLS) Arguments
Valores aceptados: false, true
--hostname

Nombre de host de la configuración de telemetría abierta.

--latency -l

Latencia de procesamiento por lotes en milisegundos. Valor mínimo: 0, valor máximo: 65535.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--mc --message-count

Número máximo de mensajes en un lote. Valor mínimo: 0, valor máximo: 4294967295.

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
--no-auth

No hay autenticación para el punto de conexión.

Propiedad Valor
Valores aceptados: false, true
--port

Número de puerto de la configuración de telemetría abierta.

--secret-name -s

El nombre del secreto de Kubernetes que contiene el certificado de cliente X509, la clave privada correspondiente al certificado de cliente y los certificados intermedios para la cadena de certificados de cliente. Nota: El certificado y la clave privada deben estar en formato PEM y no estar protegidos con contraseña.

Propiedad Valor
Grupo de parámetros: X509 Authentication Arguments
--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad Valor
Valores aceptados: false, true
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False