Compartir a través de


az iot ops dataflow endpoint create

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 create . Obtenga más información sobre las extensiones.

Cree o reemplace un recurso de punto de conexión de flujo de datos.

Comandos

Nombre Description Tipo Estado
az iot ops dataflow endpoint create adls

Cree o reemplace un recurso de punto de conexión de flujo de datos para Azure Data Lake Storage Gen2.

Extension GA
az iot ops dataflow endpoint create adx

Cree o reemplace un recurso de punto de conexión de flujo de datos para Azure Data Explorer.

Extension GA
az iot ops dataflow endpoint create custom-kafka

Cree o reemplace un recurso de punto de conexión de flujo de datos para el agente de kafka personalizado.

Extension GA
az iot ops dataflow endpoint create custom-mqtt

Cree o reemplace un recurso de punto de conexión de flujo de datos para el agente MQTT personalizado.

Extension GA
az iot ops dataflow endpoint create eventgrid

Cree o reemplace un recurso de punto de conexión de flujo de datos para Azure Event Grid.

Extension GA
az iot ops dataflow endpoint create eventhub

Cree o reemplace un recurso de punto de conexión de flujo de datos para el espacio de nombres de Azure Event Hubs habilitado para kafka.

Extension GA
az iot ops dataflow endpoint create fabric-onelake

Cree o reemplace un recurso de punto de conexión de flujo de datos para Microsoft Fabric OneLake.

Extension GA
az iot ops dataflow endpoint create fabric-realtime

Cree o reemplace un punto de conexión de flujo de datos de Inteligencia de Microsoft Fabric Real-Time.

Extension GA
az iot ops dataflow endpoint create local-mqtt

Cree o reemplace un punto de conexión de flujo de datos MQTT local de Azure IoT Operations.

Extension GA
az iot ops dataflow endpoint create local-storage

Cree o reemplace un punto de conexión de flujo de datos de almacenamiento local.

Extension GA
az iot ops dataflow endpoint create otel

Cree o reemplace un punto de conexión de flujo de datos openTelemetry.

Extension GA

az iot ops dataflow endpoint create adls

Cree o reemplace un recurso de punto de conexión de flujo de datos para Azure Data Lake Storage Gen2.

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. Nota: Cuando se usa el método de autenticación de identidad administrada asignada por el usuario, el ámbito tendrá como valor predeterminado "https://storage.azure.com/.default" si no se especifica en --scope.

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

Ejemplos

Cree o reemplace un recurso de punto de conexión de flujo de datos por una entrada mínima.

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

Cree o reemplace un recurso de punto de conexión de flujo de datos mediante el método de autenticación de identidad administrada asignada por el usuario.

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

Mostrar la configuración para crear un recurso de punto de conexión de flujo de datos.

az iot ops dataflow endpoint create adls --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --storage-account mystorageaccount --latency 70 --message-count 100 --secret-name mysecret --show-config

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

--sa --storage-account

Nombre de la cuenta de Azure Data Lake Storage Gen2.

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
Valor predeterminado: 60
--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
Valor predeterminado: 100000
--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 create adx

Cree o reemplace un recurso de punto de conexión de flujo de datos 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 create adx --database --db
                                        --host
                                        --instance
                                        --name
                                        --resource-group
                                        [--aud --audience]
                                        [--auth-type {SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                        [--cid --client-id]
                                        [--latency]
                                        [--mc --message-count]
                                        [--scope]
                                        [--show-config {false, true}]
                                        [--tenant-id --tid]

Ejemplos

Cree o reemplace un recurso de punto de conexión de flujo de datos por una entrada mínima.

az iot ops dataflow endpoint create adx --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --database mydatabase --host "https://cluster.region.kusto.windows.net"

Cree o reemplace un recurso de punto de conexión de flujo de datos mediante el método de autenticación de identidad administrada asignada por el usuario.

az iot ops dataflow endpoint create adx --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --database mydatabase --host "https://cluster.region.kusto.windows.net" --client-id 425cb1e9-1247-4cbc-8cdb-1aac9b429696 --tenant-id bca45660-49a2-4bad-862a-0b9459b4b836

Mostrar la configuración para crear un recurso de punto de conexión de flujo de datos.

az iot ops dataflow endpoint create adx --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --database mydatabase --host "https://cluster.region.kusto.windows.net" --latency 70 --message-count 100 --audience myaudience --show-config

Parámetros requeridos

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

--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
--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
Valor predeterminado: 60
--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
Valor predeterminado: 100000
--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 create custom-kafka

Cree o reemplace un recurso de punto de conexión de flujo de datos 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 create custom-kafka --hostname
                                                 --instance
                                                 --name
                                                 --port
                                                 --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]
                                                 [--latency]
                                                 [--max-bytes --mb]
                                                 [--mc --message-count]
                                                 [--no-auth {false, true}]
                                                 [--partition-strategy --ps {Default, Property, Static, Topic}]
                                                 [--sasl-type {Plain, ScramSha256, ScramSha512}]
                                                 [--scope]
                                                 [--secret-name]
                                                 [--show-config {false, true}]
                                                 [--tenant-id --tid]

Ejemplos

Cree o reemplace un recurso de punto de conexión de flujo de datos por una entrada mínima.

az iot ops dataflow endpoint create custom-kafka --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mykafkabroker --port 9092

Cree o reemplace un recurso de punto de conexión de flujo de datos mediante el método de autenticación SASL.

az iot ops dataflow endpoint create custom-kafka --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mykafkabroker --port 9092 --sasl-type ScramSha256 --secret-name mysecret

Cree o reemplace un recurso de punto de conexión de flujo de datos sin autenticación.

az iot ops dataflow endpoint create custom-kafka --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mykafkabroker --port 9092 --no-auth

Mostrar la configuración para crear un recurso de punto de conexión de flujo de datos.

az iot ops dataflow endpoint create custom-kafka --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mykafkabroker --port 9092 --disable-batching --latency 70 --max-bytes 200000 --message-count 100 --audience myaudience --config-map-ref myconfigmap --disable-tls --show-config

Parámetros requeridos

--hostname

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

--instance -i

Nombre de instancia de IoT Operations.

--name -n

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

--port

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

--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
Valor predeterminado: False
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
Valor predeterminado: False
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
Valor predeterminado: False
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.

--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
Valor predeterminado: 5
--max-bytes --mb

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

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
Valor predeterminado: 1000000
--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
Valor predeterminado: 100000
--no-auth

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

Propiedad Valor
Valor predeterminado: False
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
--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 create custom-mqtt

Cree o reemplace un recurso de punto de conexión de flujo de datos 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 create custom-mqtt --hostname
                                                --instance
                                                --name
                                                --port
                                                --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}]
                                                [--ka --keep-alive]
                                                [--max-inflight-msg --mim]
                                                [--no-auth {false, true}]
                                                [--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

Cree o reemplace un recurso de punto de conexión de flujo de datos por una entrada mínima.

az iot ops dataflow endpoint create custom-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mymqttbroker --port 9092

Cree o reemplace un recurso de punto de conexión de flujo de datos mediante el método de autenticación de token de cuenta de Servicio de Kubernetes.

az iot ops dataflow endpoint create custom-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mymqttbroker --port 9092 --sat-audience myaudience --secret-name mysecret

Cree o reemplace un recurso de punto de conexión de flujo de datos sin autenticación.

az iot ops dataflow endpoint create custom-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mymqttbroker --port 9092 --no-auth

Mostrar la configuración para crear un recurso de punto de conexión de flujo de datos.

az iot ops dataflow endpoint create custom-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mymqttbroker --port 9092 --client-id-prefix myclientprefix --keep-alive 100 --max-inflight-msg 60 --protocol WebSockets --qos 1 --retain Never --session-expiry 100 --cloud-event-attribute CreateOrRemap --secret-name mysecret --disable-tls --show-config

Parámetros requeridos

--hostname

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

--instance -i

Nombre de instancia de IoT Operations.

--name -n

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

--port

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

--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
Valor predeterminado: False
Valores aceptados: false, true
--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.

Propiedad Valor
Valor predeterminado: 60
--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.

Propiedad Valor
Valor predeterminado: 100
--no-auth

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

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--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.

Propiedad Valor
Valor predeterminado: 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.

Propiedad Valor
Valor predeterminado: 3600
--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 create eventgrid

Cree o reemplace un recurso de punto de conexión de flujo de datos 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 create eventgrid --hostname
                                              --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]
                                              [--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

Cree o reemplace un recurso de punto de conexión de flujo de datos por una entrada mínima.

az iot ops dataflow endpoint create eventgrid --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname "namespace.region-1.ts.eventgrid.azure.net" --port 9092

Cree o reemplace un recurso de punto de conexión de flujo de datos mediante el método de autenticación X509.

az iot ops dataflow endpoint create eventgrid --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname "namespace.region-1.ts.eventgrid.azure.net" --port 9092 --secret-name mysecret

Mostrar la configuración para crear un recurso de punto de conexión de flujo de datos.

az iot ops dataflow endpoint create eventgrid --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname "namespace.region-1.ts.eventgrid.azure.net" --port 9092 --client-id-prefix myclientprefix --keep-alive 100 --max-inflight-msg 60 --protocol WebSockets --qos 1 --retain Never --session-expiry 100 --cloud-event-attribute CreateOrRemap --secret-name mysecret --config-map-ref myconfigmap --show-config

Parámetros requeridos

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

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

Propiedad Valor
Valor predeterminado: 60
--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.

Propiedad Valor
Valor predeterminado: 100
--port

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

Propiedad Valor
Valor predeterminado: 8883
--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.

Propiedad Valor
Valor predeterminado: 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.

Propiedad Valor
Valor predeterminado: 3600
--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 create eventhub

Cree o reemplace un recurso de punto de conexión de flujo de datos para el espacio de nombres de Azure Event Hubs habilitado para kafka.

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 create eventhub --ehns --eventhub-namespace
                                             --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}]
                                             [--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

Cree o reemplace un recurso de punto de conexión de flujo de datos por una entrada mínima.

az iot ops dataflow endpoint create eventhub --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --eventhub-namespace myeventhubnamespace

Cree o reemplace un recurso de punto de conexión de flujo de datos mediante el método de autenticación de identidad administrada asignada por el usuario.

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

Mostrar la configuración para crear un recurso de punto de conexión de flujo de datos.

az iot ops dataflow endpoint create eventhub --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --eventhub-namespace myeventhubnamespace --acks One --compression Gzip --disable-broker-props-copy --group-id mygroupid --partition-strategy Static --max-bytes 200000 --message-count 100 --latency 70 --cloud-event-attribute CreateOrRemap --sasl-type ScramSha256 --secret-name mysecret --config-map-ref myconfigmap --show-config

Parámetros requeridos

--ehns --eventhub-namespace

Nombre del espacio de nombres de Event Hubs.

--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
Valor predeterminado: False
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
Valor predeterminado: False
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.

--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
Valor predeterminado: 5
--max-bytes --mb

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

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
Valor predeterminado: 1000000
--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
Valor predeterminado: 100000
--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 create fabric-onelake

Cree o reemplace un recurso de punto de conexión de flujo de datos 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 create fabric-onelake --instance
                                                   --lakehouse
                                                   --name
                                                   --path-type --pt {Files, Tables}
                                                   --resource-group
                                                   --workspace
                                                   [--aud --audience]
                                                   [--auth-type {SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                                   [--cid --client-id]
                                                   [--latency]
                                                   [--mc --message-count]
                                                   [--scope]
                                                   [--show-config {false, true}]
                                                   [--tenant-id --tid]

Ejemplos

Cree o reemplace un recurso de punto de conexión de flujo de datos por una entrada mínima.

az iot ops dataflow endpoint create fabric-onelake --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --lakehouse mylakehouse --workspace myworkspace --path-type Files

Cree o reemplace un recurso de punto de conexión de flujo de datos mediante el método de autenticación de identidad administrada asignada por el usuario.

az iot ops dataflow endpoint create fabric-onelake --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --lakehouse mylakehouse --workspace myworkspace --path-type Files --client-id 425cb1e9-1247-4cbc-8cdb-1aac9b429696 --tenant-id bca45660-49a2-4bad-862a-0b9459b4b836

Mostrar la configuración para crear un recurso de punto de conexión de flujo de datos.

az iot ops dataflow endpoint create fabric-onelake --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --lakehouse mylakehouse --workspace myworkspace --path-type Files --latency 70 --message-count 100 --audience myaudience --show-config

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--lakehouse

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

--name -n

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

--path-type --pt

Tipo de ruta de acceso usada en OneLake.

Propiedad Valor
Valores aceptados: Files, Tables
--resource-group -g

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

--workspace

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

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
--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
Valor predeterminado: 60
--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
Valor predeterminado: 100000
--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 create fabric-realtime

Cree o reemplace un punto de conexión de flujo de datos de Inteligencia de Microsoft Fabric 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 create fabric-realtime --host
                                                    --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]
                                                    [--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

Cree o reemplace un recurso de punto de conexión de flujo de datos por una entrada mínima.

az iot ops dataflow endpoint create fabric-realtime --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --host "fabricrealtime.servicebus.windows.net:9093"

Cree o reemplace un recurso de punto de conexión de flujo de datos mediante el método de autenticación SASL.

az iot ops dataflow endpoint create fabric-realtime --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --host "fabricrealtime.servicebus.windows.net:9093" --sasl-type ScramSha256 --secret-name mysecret

Mostrar la configuración para crear un recurso de punto de conexión de flujo de datos.

az iot ops dataflow endpoint create fabric-realtime --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --host "fabricrealtime.servicebus.windows.net:9093" --acks One --compression Gzip --group-id mygroupid --partition-strategy Static --max-bytes 200000 --cloud-event-attribute CreateOrRemap --disable-tls --show-config

Parámetros requeridos

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

--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
Valor predeterminado: False
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
Valor predeterminado: False
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
Valor predeterminado: False
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.

--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
Valor predeterminado: 5
--max-bytes --mb

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

Propiedad Valor
Grupo de parámetros: Batching Configuration Arguments
Valor predeterminado: 1000000
--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
Valor predeterminado: 100000
--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 create local-mqtt

Cree o reemplace un punto de conexión de flujo de datos MQTT local de Azure IoT Operations.

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 create local-mqtt --hostname
                                               --instance
                                               --name
                                               --port
                                               --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}]
                                               [--ka --keep-alive]
                                               [--max-inflight-msg --mim]
                                               [--no-auth {false, true}]
                                               [--protocol {Mqtt, WebSockets}]
                                               [--qos]
                                               [--retain {Keep, Never}]
                                               [--secret-name]
                                               [--session-expiry]
                                               [--show-config {false, true}]

Ejemplos

Cree o reemplace un recurso de punto de conexión de flujo de datos por una entrada mínima.

az iot ops dataflow endpoint create local-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname aio-broker --port 1883

Cree o reemplace un recurso de punto de conexión de flujo de datos mediante el método de autenticación X509.

az iot ops dataflow endpoint create local-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname aio-broker --port 1883 --secret-name mysecret

Cree o reemplace un recurso de punto de conexión de flujo de datos sin autenticación.

az iot ops dataflow endpoint create local-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname aio-broker --port 1883 --no-auth

Mostrar la configuración para crear un recurso de punto de conexión de flujo de datos.

az iot ops dataflow endpoint create local-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname aio-broker --port 1883 --client-id-prefix myclientprefix --keep-alive 100 --max-inflight-msg 70 --protocol WebSockets --qos 0 --retain Never --show-config

Parámetros requeridos

--hostname

Nombre de host del agente MQTT local.

--instance -i

Nombre de instancia de IoT Operations.

--name -n

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

--port

Número de puerto del agente MQTT local.

--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
Valor predeterminado: azure-iot-operations-aio-ca-trust-bundle
--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
--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.

Propiedad Valor
Valor predeterminado: 60
--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.

Propiedad Valor
Valor predeterminado: 100
--no-auth

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

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--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.

Propiedad Valor
Valor predeterminado: 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.

Propiedad Valor
Valor predeterminado: 3600
--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 create local-storage

Cree o reemplace un punto de conexión de flujo de datos de almacenamiento local.

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 create local-storage --instance
                                                  --name
                                                  --pvc-ref
                                                  --resource-group
                                                  [--show-config {false, true}]

Ejemplos

Cree o reemplace un recurso de punto de conexión de flujo de datos por una entrada mínima.

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

Mostrar la configuración para crear un recurso de punto de conexión de flujo de datos.

az iot ops dataflow endpoint create local-storage --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --pvc-ref mypvc --show-config

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--name -n

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

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

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

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

Cree o reemplace un punto de conexión de flujo de datos openTelemetry.

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 create otel --hostname
                                         --instance
                                         --name
                                         --port
                                         --resource-group
                                         [--aud --audience]
                                         [--auth-type {ServiceAccountToken, X509Certificate}]
                                         [--cm --config-map-ref]
                                         [--disable-tls {false, true}]
                                         [--latency]
                                         [--mc --message-count]
                                         [--no-auth {false, true}]
                                         [--secret-name]
                                         [--show-config {false, true}]

Ejemplos

Cree o reemplace un recurso de punto de conexión de flujo de datos por una entrada mínima.

az iot ops dataflow endpoint create otel --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --name myendpoint --hostname https://otel-collector.monitoring.svc.cluster.local --port 4317 --no-auth

Mostrar la configuración para crear un recurso de punto de conexión de flujo de datos.

az iot ops dataflow endpoint create otel --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname https://otel-collector.monitoring.svc.cluster.local --port 4317 --no-auth --show-config

Cree o reemplace un recurso de punto de conexión de flujo de datos mediante el método de autenticación X509.

az iot ops dataflow endpoint create otel --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname https://otel-collector.monitoring.svc.cluster.local --port 4317 --secret-name mysecret

Parámetros requeridos

--hostname

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

--instance -i

Nombre de instancia de IoT Operations.

--name -n

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

--port

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

--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
Valor predeterminado: False
Valores aceptados: false, true
--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
Valor predeterminado: 60
--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
Valor predeterminado: 100000
--no-auth

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

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--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