Compartilhar via


az iot ops dataflow endpoint create

Note

Essa referência faz parte da extensão azure-iot-ops para a CLI do Azure (versão 2.67.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando de criação de ponto de extremidade de fluxo de dados do az iot ops . Saiba mais sobre extensões.

Criar ou substituir um recurso de ponto de extremidade de fluxo de dados.

Comandos

Nome Description Tipo Status
az iot ops dataflow endpoint create adls

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para o Azure Data Lake Storage Gen2.

Extension GA
az iot ops dataflow endpoint create adx

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para o Azure Data Explorer.

Extension GA
az iot ops dataflow endpoint create custom-kafka

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para o agente kafka personalizado.

Extension GA
az iot ops dataflow endpoint create custom-mqtt

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para um agente MQTT personalizado.

Extension GA
az iot ops dataflow endpoint create eventgrid

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para a Grade de Eventos do Azure.

Extension GA
az iot ops dataflow endpoint create eventhub

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para o namespace dos Hubs de Eventos do Azure habilitado para kafka.

Extension GA
az iot ops dataflow endpoint create fabric-onelake

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para o Microsoft Fabric OneLake.

Extension GA
az iot ops dataflow endpoint create fabric-realtime

Crie ou substitua um ponto de extremidade de fluxo de dados do Microsoft Fabric Real-Time Intelligence.

Extension GA
az iot ops dataflow endpoint create local-mqtt

Crie ou substitua um ponto de extremidade de fluxo de dados MQTT local das Operações IoT do Azure.

Extension GA
az iot ops dataflow endpoint create local-storage

Crie ou substitua um ponto de extremidade de fluxo de dados de armazenamento local.

Extension GA
az iot ops dataflow endpoint create otel

Crie ou substitua um ponto de extremidade de fluxo de dados OpenTelemetry.

Extension GA

az iot ops dataflow endpoint create adls

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para o Azure Data Lake Storage Gen2.

Para obter mais informações sobre o ponto de extremidade de fluxo de dados do Azure Data Lake Storage Gen2, consulte https://aka.ms/adlsv2. Observação: ao usar o método de autenticação de identidade gerenciada atribuído pelo usuário, o escopo será padrão para 'https://storage.azure.com/.default' se não for especificado por --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]

Exemplos

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados por entrada mínima.

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

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados usando o método de autenticação de identidade gerenciada atribuído pelo usuário.

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 configuração para criar um recurso de ponto de extremidade de fluxo de dados.

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 Exigidos

--instance -i

Nome da instância de operações de IoT.

--name -n

Nome do ponto de extremidade do fluxo de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--sa --storage-account

O nome da conta do Azure Data Lake Storage Gen2.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--aud --audience

Público-alvo do serviço no qual se autenticar.

Propriedade Valor
Grupo de parâmetros: System Assigned Managed Identity Arguments
--auth-type

O tipo de autenticação para o ponto de extremidade do fluxo de dados. Observação: quando não especificado, o tipo de autenticação é determinado por outros parâmetros de autenticação.

Propriedade Valor
Valores aceitos: AccessToken, SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cid --client-id

A ID do cliente da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--latency -l

A latência de envio em lote em milissegundos. Valor mínimo: 0, valor máximo: 65535.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 60
--mc --message-count

Número máximo de mensagens em um lote. Valor mínimo: 0, valor máximo: 4294967295.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 100000
--scope

Identificador de recurso (URI da ID do aplicativo) do recurso, afixado com o sufixo .default.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--secret-name -s

O nome do segredo kubernetes que contém o token SAS.

Propriedade Valor
Grupo de parâmetros: Access Token Arguments
--show-config

Mostrar a configuração de recurso gerada em vez de invocar a API com ela.

Propriedade Valor
Valores aceitos: false, true
--tenant-id --tid

A ID do locatário da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot ops dataflow endpoint create adx

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para o Azure Data Explorer.

Para obter mais informações sobre o ponto de extremidade de fluxo de dados do 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]

Exemplos

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados por 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"

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados usando o método de autenticação de identidade gerenciada atribuído pelo usuário.

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 configuração para criar um recurso de ponto de extremidade de fluxo de dados.

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 Exigidos

--database --db

O nome do banco de dados do Azure Data Explorer.

--host

O host do Azure Data Explorer é o URI do cluster do Azure Data Explorer. Na forma de https://cluster.region.kusto.windows.net.

--instance -i

Nome da instância de operações de IoT.

--name -n

Nome do ponto de extremidade do fluxo de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--aud --audience

Público-alvo do serviço no qual se autenticar.

Propriedade Valor
Grupo de parâmetros: System Assigned Managed Identity Arguments
--auth-type

O tipo de autenticação para o ponto de extremidade do fluxo de dados. Observação: quando não especificado, o tipo de autenticação é determinado por outros parâmetros de autenticação.

Propriedade Valor
Valores aceitos: SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cid --client-id

A ID do cliente da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--latency -l

A latência de envio em lote em milissegundos. Valor mínimo: 0, valor máximo: 65535.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 60
--mc --message-count

Número máximo de mensagens em um lote. Valor mínimo: 0, valor máximo: 4294967295.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 100000
--scope

Identificador de recurso (URI da ID do aplicativo) do recurso, afixado com o sufixo .default.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--show-config

Mostrar a configuração de recurso gerada em vez de invocar a API com ela.

Propriedade Valor
Valores aceitos: false, true
--tenant-id --tid

A ID do locatário da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot ops dataflow endpoint create custom-kafka

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para o agente kafka personalizado.

Para obter mais informações sobre o ponto de extremidade de fluxo de dados 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]

Exemplos

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados por entrada mínima.

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

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados usando o método de autenticação 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

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados sem autenticação.

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

Mostrar configuração para criar um recurso de ponto de extremidade de fluxo de dados.

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 Exigidos

--hostname

O nome do host da configuração de host do agente kafka.

--instance -i

Nome da instância de operações de IoT.

--name -n

Nome do ponto de extremidade do fluxo de dados.

--port

O número da porta da configuração de host do agente kafka.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acks

Nível de confirmação do agente kafka para garantir que a mensagem enviada pelo produtor seja gravada com êxito no tópico e replicada no cluster Kafka.

Propriedade Valor
Valor padrão: All
Valores aceitos: All, One, Zero
--aud --audience

Público-alvo do serviço no qual se autenticar.

Propriedade Valor
Grupo de parâmetros: System Assigned Managed Identity Arguments
--auth-type

O tipo de autenticação para o ponto de extremidade do fluxo de dados. Observação: quando não especificado, o tipo de autenticação é determinado por outros parâmetros de autenticação.

Propriedade Valor
Valores aceitos: Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cea --cloud-event-attribute

As configurações do CloudEvent digitam para mapear eventos para a nuvem. Formato de mensagem diferente é exigido por configuração diferente.

Propriedade Valor
Grupo de parâmetros: Cloud Event Arguments
Valor padrão: Propagate
Valores aceitos: CreateOrRemap, Propagate
--cid --client-id

A ID do cliente da identidade atribuída pelo usuário.

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

Referência de mapa de configuração para o certificado de AC confiável para o ponto de extremidade Kafka/MQTT. Observação: este ConfigMap deve conter o certificado de AC no formato PEM. O ConfigMap deve estar no mesmo namespace que o recurso de fluxo de dados Kafka/MQTT.

Propriedade Valor
Grupo de parâmetros: Transport Layer Security (TLS) Arguments
--compression

Tipo de compactação para as mensagens enviadas aos tópicos do Kafka.

Propriedade Valor
Valor padrão: None
Valores aceitos: Gzip, Lz4, None, Snappy
--db --disable-batching

Desabilite o envio em lote.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: False
Valores aceitos: false, true
--dbpc --disable-broker-props-copy

Desabilite a cópia de propriedades do agente do MQTT para cabeçalhos de usuário do Kafka.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--disable-tls

O fluxo de dados usa uma conexão insegura com o agente Kafka/MQTT.

Propriedade Valor
Grupo de parâmetros: Transport Layer Security (TLS) Arguments
Valor padrão: False
Valores aceitos: false, true
--gid --group-id

ID do grupo de consumidores que o fluxo de dados usa para ler mensagens do tópico kafka.

--latency -l

A latência de envio em lote em milissegundos. Valor mínimo: 0, valor máximo: 65535.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 5
--max-bytes --mb

Número máximo de bytes em um lote.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 1000000
--mc --message-count

Número máximo de mensagens em um lote. Valor mínimo: 0, valor máximo: 4294967295.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 100000
--no-auth

Nenhuma autenticação para o ponto de extremidade.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--partition-strategy --ps

A estratégia de tratamento de partição controla como as mensagens são atribuídas às partições do Kafka ao enviá-las para tópicos do Kafka.

Propriedade Valor
Valor padrão: Default
Valores aceitos: Default, Property, Static, Topic
--sasl-type

O tipo de autenticação SASL.

Propriedade Valor
Grupo de parâmetros: SASL Authentication Arguments
Valores aceitos: Plain, ScramSha256, ScramSha512
--scope

Identificador de recurso (URI da ID do aplicativo) do recurso, afixado com o sufixo .default.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--secret-name -s

O nome do segredo do Kubernetes que contém o token de SASL.

Propriedade Valor
Grupo de parâmetros: SASL Authentication Arguments
--show-config

Mostrar a configuração de recurso gerada em vez de invocar a API com ela.

Propriedade Valor
Valores aceitos: false, true
--tenant-id --tid

A ID do locatário da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot ops dataflow endpoint create custom-mqtt

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para um agente MQTT personalizado.

Para obter mais informações sobre o ponto de extremidade de fluxo de dados 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]

Exemplos

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados por entrada mínima.

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

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados usando o método de autenticação de Token de Conta de Serviço do 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

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados sem autenticação.

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

Mostrar configuração para criar um recurso de ponto de extremidade de fluxo de dados.

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 Exigidos

--hostname

O nome do host da configuração personalizada do host do agente MQTT.

--instance -i

Nome da instância de operações de IoT.

--name -n

Nome do ponto de extremidade do fluxo de dados.

--port

O número da porta da configuração personalizada do host do agente MQTT.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--auth-type

O tipo de autenticação para o ponto de extremidade do fluxo de dados. Observação: quando não especificado, o tipo de autenticação é determinado por outros parâmetros de autenticação.

Propriedade Valor
Valores aceitos: ServiceAccountToken, SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate
--cea --cloud-event-attribute

As configurações do CloudEvent digitam para mapear eventos para a nuvem. Formato de mensagem diferente é exigido por configuração diferente.

Propriedade Valor
Grupo de parâmetros: Cloud Event Arguments
Valor padrão: Propagate
Valores aceitos: CreateOrRemap, Propagate
--cid --client-id

A ID do cliente da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--client-id-prefix

O prefixo de ID do cliente para o cliente MQTT. Observação: alterar o prefixo da ID do cliente após a implantação das Operações de IoT pode resultar em perda de dados.

--cm --config-map-ref

Referência de mapa de configuração para o certificado de AC confiável para o ponto de extremidade Kafka/MQTT. Observação: este ConfigMap deve conter o certificado de AC no formato PEM. O ConfigMap deve estar no mesmo namespace que o recurso de fluxo de dados Kafka/MQTT.

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

O fluxo de dados usa uma conexão insegura com o agente Kafka/MQTT.

Propriedade Valor
Grupo de parâmetros: Transport Layer Security (TLS) Arguments
Valor padrão: False
Valores aceitos: false, true
--ka --keep-alive

O tempo máximo em segundos em que o cliente de fluxo de dados pode ficar ocioso antes de enviar uma mensagem PINGREQ para o agente. Valor mínimo: 0.

Propriedade Valor
Valor padrão: 60
--max-inflight-msg --mim

O número máximo de mensagens de bordo que o cliente MQTT de fluxo de dados pode ter. Valor mínimo: 0.

Propriedade Valor
Valor padrão: 100
--no-auth

Nenhuma autenticação para o ponto de extremidade.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--protocol

Protocolo a ser usado para conexões de cliente.

Propriedade Valor
Valor padrão: Mqtt
Valores aceitos: Mqtt, WebSockets
--qos

Nível de QoS (qualidade de serviço) para as mensagens MQTT. Há suporte apenas para 0 ou 1.

Propriedade Valor
Valor padrão: 1
--retain

Mantenha a configuração para especificar se o fluxo de dados deve manter o sinalizador de retenção em mensagens MQTT. Definir isso garante se o agente remoto tem ou não as mesmas mensagens retidas que o agente local.

Propriedade Valor
Valor padrão: Keep
Valores aceitos: Keep, Never
--sami-aud --sami-audience

O público-alvo da identidade gerenciada atribuída pelo sistema.

Propriedade Valor
Grupo de parâmetros: System Assigned Managed Identity Arguments
--sat-aud --sat-audience

O público-alvo do token de conta de serviço do Kubernetes (SAT).

Propriedade Valor
Grupo de parâmetros: Kubernetes Service Account Token Arguments
--scope

Identificador de recurso (URI da ID do aplicativo) do recurso, afixado com o sufixo .default.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--secret-name -s

O nome do segredo do kubernetes que contém o certificado de cliente X509, a chave privada correspondente ao certificado do cliente e os certificados intermediários da cadeia de certificados do cliente. Observação: o certificado e a chave privada devem estar no formato PEM e não protegidos por senha.

Propriedade Valor
Grupo de parâmetros: X509 Authentication Arguments
--session-expiry

O intervalo de expiração da sessão em segundos para o cliente MQTT do fluxo de dados. Valor mínimo: 0.

Propriedade Valor
Valor padrão: 3600
--show-config

Mostrar a configuração de recurso gerada em vez de invocar a API com ela.

Propriedade Valor
Valores aceitos: false, true
--tenant-id --tid

A ID do locatário da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot ops dataflow endpoint create eventgrid

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para a Grade de Eventos do Azure.

Para obter mais informações sobre o ponto de extremidade do fluxo de dados da Grade de Eventos do Azure, 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]

Exemplos

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados por 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

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados usando o método de autenticação 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 configuração para criar um recurso de ponto de extremidade de fluxo de dados.

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 Exigidos

--hostname

O nome do host do namespace da grade de eventos. Pode ser encontrado na propriedade 'Nome do host Http'. Na forma de NAMESPACE.REGION-1.ts.eventgrid.azure.net.

--instance -i

Nome da instância de operações de IoT.

--name -n

Nome do ponto de extremidade do fluxo de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--aud --audience

Público-alvo do serviço no qual se autenticar.

Propriedade Valor
Grupo de parâmetros: System Assigned Managed Identity Arguments
--auth-type

O tipo de autenticação para o ponto de extremidade do fluxo de dados. Observação: quando não especificado, o tipo de autenticação é determinado por outros parâmetros de autenticação.

Propriedade Valor
Valores aceitos: SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate
--cea --cloud-event-attribute

As configurações do CloudEvent digitam para mapear eventos para a nuvem. Formato de mensagem diferente é exigido por configuração diferente.

Propriedade Valor
Grupo de parâmetros: Cloud Event Arguments
Valor padrão: Propagate
Valores aceitos: CreateOrRemap, Propagate
--cid --client-id

A ID do cliente da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--client-id-prefix

O prefixo de ID do cliente para o cliente MQTT. Observação: alterar o prefixo da ID do cliente após a implantação das Operações de IoT pode resultar em perda de dados.

--cm --config-map-ref

Referência de mapa de configuração para o certificado de AC confiável para o ponto de extremidade Kafka/MQTT. Observação: este ConfigMap deve conter o certificado de AC no formato PEM. O ConfigMap deve estar no mesmo namespace que o recurso de fluxo de dados Kafka/MQTT.

Propriedade Valor
Grupo de parâmetros: Transport Layer Security (TLS) Arguments
--ka --keep-alive

O tempo máximo em segundos em que o cliente de fluxo de dados pode ficar ocioso antes de enviar uma mensagem PINGREQ para o agente. Valor mínimo: 0.

Propriedade Valor
Valor padrão: 60
--max-inflight-msg --mim

O número máximo de mensagens de bordo que o cliente MQTT de fluxo de dados pode ter. Valor mínimo: 0.

Propriedade Valor
Valor padrão: 100
--port

O número da porta do namespace da grade de eventos.

Propriedade Valor
Valor padrão: 8883
--protocol

Protocolo a ser usado para conexões de cliente.

Propriedade Valor
Valor padrão: Mqtt
Valores aceitos: Mqtt, WebSockets
--qos

Nível de QoS (qualidade de serviço) para as mensagens MQTT. Há suporte apenas para 0 ou 1.

Propriedade Valor
Valor padrão: 1
--retain

Mantenha a configuração para especificar se o fluxo de dados deve manter o sinalizador de retenção em mensagens MQTT. Definir isso garante se o agente remoto tem ou não as mesmas mensagens retidas que o agente local.

Propriedade Valor
Valor padrão: Keep
Valores aceitos: Keep, Never
--scope

Identificador de recurso (URI da ID do aplicativo) do recurso, afixado com o sufixo .default.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--secret-name -s

O nome do segredo do kubernetes que contém o certificado de cliente X509, a chave privada correspondente ao certificado do cliente e os certificados intermediários da cadeia de certificados do cliente. Observação: o certificado e a chave privada devem estar no formato PEM e não protegidos por senha.

Propriedade Valor
Grupo de parâmetros: X509 Authentication Arguments
--session-expiry

O intervalo de expiração da sessão em segundos para o cliente MQTT do fluxo de dados. Valor mínimo: 0.

Propriedade Valor
Valor padrão: 3600
--show-config

Mostrar a configuração de recurso gerada em vez de invocar a API com ela.

Propriedade Valor
Valores aceitos: false, true
--tenant-id --tid

A ID do locatário da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot ops dataflow endpoint create eventhub

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para o namespace dos Hubs de Eventos do Azure habilitado para kafka.

Para obter mais informações sobre o ponto de extremidade de fluxo de dados dos Hubs de Eventos do Azure, 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]

Exemplos

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados por entrada mínima.

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

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados usando o método de autenticação de identidade gerenciada atribuído pelo usuário.

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 configuração para criar um recurso de ponto de extremidade de fluxo de dados.

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 Exigidos

--ehns --eventhub-namespace

O nome do namespace dos Hubs de Eventos.

--instance -i

Nome da instância de operações de IoT.

--name -n

Nome do ponto de extremidade do fluxo de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acks

Nível de confirmação do agente kafka para garantir que a mensagem enviada pelo produtor seja gravada com êxito no tópico e replicada no cluster Kafka.

Propriedade Valor
Valor padrão: All
Valores aceitos: All, One, Zero
--aud --audience

Público-alvo do serviço no qual se autenticar.

Propriedade Valor
Grupo de parâmetros: System Assigned Managed Identity Arguments
--auth-type

O tipo de autenticação para o ponto de extremidade do fluxo de dados. Observação: quando não especificado, o tipo de autenticação é determinado por outros parâmetros de autenticação.

Propriedade Valor
Valores aceitos: Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cea --cloud-event-attribute

As configurações do CloudEvent digitam para mapear eventos para a nuvem. Formato de mensagem diferente é exigido por configuração diferente.

Propriedade Valor
Grupo de parâmetros: Cloud Event Arguments
Valor padrão: Propagate
Valores aceitos: CreateOrRemap, Propagate
--cid --client-id

A ID do cliente da identidade atribuída pelo usuário.

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

Referência de mapa de configuração para o certificado de AC confiável para o ponto de extremidade Kafka/MQTT. Observação: este ConfigMap deve conter o certificado de AC no formato PEM. O ConfigMap deve estar no mesmo namespace que o recurso de fluxo de dados Kafka/MQTT.

Propriedade Valor
Grupo de parâmetros: Transport Layer Security (TLS) Arguments
--compression

Tipo de compactação para as mensagens enviadas aos tópicos do Kafka.

Propriedade Valor
Valor padrão: None
Valores aceitos: Gzip, Lz4, None, Snappy
--db --disable-batching

Desabilite o envio em lote.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: False
Valores aceitos: false, true
--dbpc --disable-broker-props-copy

Desabilite a cópia de propriedades do agente do MQTT para cabeçalhos de usuário do Kafka.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--gid --group-id

ID do grupo de consumidores que o fluxo de dados usa para ler mensagens do tópico kafka.

--latency -l

A latência de envio em lote em milissegundos. Valor mínimo: 0, valor máximo: 65535.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 5
--max-bytes --mb

Número máximo de bytes em um lote.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 1000000
--mc --message-count

Número máximo de mensagens em um lote. Valor mínimo: 0, valor máximo: 4294967295.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 100000
--partition-strategy --ps

A estratégia de tratamento de partição controla como as mensagens são atribuídas às partições do Kafka ao enviá-las para tópicos do Kafka.

Propriedade Valor
Valor padrão: Default
Valores aceitos: Default, Property, Static, Topic
--sasl-type

O tipo de autenticação SASL.

Propriedade Valor
Grupo de parâmetros: SASL Authentication Arguments
Valores aceitos: Plain, ScramSha256, ScramSha512
--scope

Identificador de recurso (URI da ID do aplicativo) do recurso, afixado com o sufixo .default.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--secret-name -s

O nome do segredo kubernetes que contém a cadeia de conexão do hub de eventos. Observação: o segredo deve estar no mesmo namespace que o ponto de extremidade de fluxo de dados kafka. O segredo deve ter o nome de usuário e a senha como pares chave-valor. Para obter mais informações sobre o formato secreto, consulte o link na descrição do comando.

Propriedade Valor
Grupo de parâmetros: SASL Authentication Arguments
--show-config

Mostrar a configuração de recurso gerada em vez de invocar a API com ela.

Propriedade Valor
Valores aceitos: false, true
--tenant-id --tid

A ID do locatário da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot ops dataflow endpoint create fabric-onelake

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados para o Microsoft Fabric OneLake.

Para obter mais informações sobre o ponto de extremidade de fluxo de dados do Microsoft Fabric OneLake, 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]

Exemplos

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados por 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

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados usando o método de autenticação de identidade gerenciada atribuído pelo usuário.

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 configuração para criar um recurso de ponto de extremidade de fluxo de dados.

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 Exigidos

--instance -i

Nome da instância de operações de IoT.

--lakehouse

O nome do Lakehouse do Microsoft Fabric no workspace fornecido.

--name -n

Nome do ponto de extremidade do fluxo de dados.

--path-type --pt

O tipo de caminho usado no OneLake.

Propriedade Valor
Valores aceitos: Files, Tables
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace

O nome do workspace do Microsoft Fabric. Observação: o 'meu workspace' padrão não tem suporte.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--aud --audience

Público-alvo do serviço no qual se autenticar.

Propriedade Valor
Grupo de parâmetros: System Assigned Managed Identity Arguments
--auth-type

O tipo de autenticação para o ponto de extremidade do fluxo de dados. Observação: quando não especificado, o tipo de autenticação é determinado por outros parâmetros de autenticação.

Propriedade Valor
Valores aceitos: SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cid --client-id

A ID do cliente da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--latency -l

A latência de envio em lote em milissegundos. Valor mínimo: 0, valor máximo: 65535.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 60
--mc --message-count

Número máximo de mensagens em um lote. Valor mínimo: 0, valor máximo: 4294967295.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 100000
--scope

Identificador de recurso (URI da ID do aplicativo) do recurso, afixado com o sufixo .default.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--show-config

Mostrar a configuração de recurso gerada em vez de invocar a API com ela.

Propriedade Valor
Valores aceitos: false, true
--tenant-id --tid

A ID do locatário da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot ops dataflow endpoint create fabric-realtime

Crie ou substitua um ponto de extremidade de fluxo de dados do Microsoft Fabric Real-Time Intelligence.

Para obter mais informações sobre o ponto de extremidade do fluxo de dados do Microsoft Fabric Real-Time Intelligence, 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]

Exemplos

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados por 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"

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados usando o método de autenticação 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 configuração para criar um recurso de ponto de extremidade de fluxo de dados.

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 Exigidos

--host

O host do Fabric em tempo real é o valor do 'servidor Bootstrap'. Pode ser encontrado no destino do fluxo de eventos – seção "Autenticação de Chave SAS". Na forma de *.servicebus.windows.net:9093.

--instance -i

Nome da instância de operações de IoT.

--name -n

Nome do ponto de extremidade do fluxo de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acks

Nível de confirmação do agente kafka para garantir que a mensagem enviada pelo produtor seja gravada com êxito no tópico e replicada no cluster Kafka.

Propriedade Valor
Valor padrão: All
Valores aceitos: All, One, Zero
--aud --audience

Público-alvo do serviço no qual se autenticar.

Propriedade Valor
Grupo de parâmetros: System Assigned Managed Identity Arguments
--auth-type

O tipo de autenticação para o ponto de extremidade do fluxo de dados. Observação: quando não especificado, o tipo de autenticação é determinado por outros parâmetros de autenticação.

Propriedade Valor
Valores aceitos: Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity
--cea --cloud-event-attribute

As configurações do CloudEvent digitam para mapear eventos para a nuvem. Formato de mensagem diferente é exigido por configuração diferente.

Propriedade Valor
Grupo de parâmetros: Cloud Event Arguments
Valor padrão: Propagate
Valores aceitos: CreateOrRemap, Propagate
--cid --client-id

A ID do cliente da identidade atribuída pelo usuário.

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

Referência de mapa de configuração para o certificado de AC confiável para o ponto de extremidade Kafka/MQTT. Observação: este ConfigMap deve conter o certificado de AC no formato PEM. O ConfigMap deve estar no mesmo namespace que o recurso de fluxo de dados Kafka/MQTT.

Propriedade Valor
Grupo de parâmetros: Transport Layer Security (TLS) Arguments
--compression

Tipo de compactação para as mensagens enviadas aos tópicos do Kafka.

Propriedade Valor
Valor padrão: None
Valores aceitos: Gzip, Lz4, None, Snappy
--db --disable-batching

Desabilite o envio em lote.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: False
Valores aceitos: false, true
--dbpc --disable-broker-props-copy

Desabilite a cópia de propriedades do agente do MQTT para cabeçalhos de usuário do Kafka.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--disable-tls

O fluxo de dados usa uma conexão insegura com o agente Kafka/MQTT.

Propriedade Valor
Grupo de parâmetros: Transport Layer Security (TLS) Arguments
Valor padrão: False
Valores aceitos: false, true
--gid --group-id

ID do grupo de consumidores que o fluxo de dados usa para ler mensagens do tópico kafka.

--latency -l

A latência de envio em lote em milissegundos. Valor mínimo: 0, valor máximo: 65535.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 5
--max-bytes --mb

Número máximo de bytes em um lote.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 1000000
--mc --message-count

Número máximo de mensagens em um lote. Valor mínimo: 0, valor máximo: 4294967295.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 100000
--partition-strategy --ps

A estratégia de tratamento de partição controla como as mensagens são atribuídas às partições do Kafka ao enviá-las para tópicos do Kafka.

Propriedade Valor
Valor padrão: Default
Valores aceitos: Default, Property, Static, Topic
--sasl-type

O tipo de autenticação SASL.

Propriedade Valor
Grupo de parâmetros: SASL Authentication Arguments
Valores aceitos: Plain, ScramSha256, ScramSha512
--scope

Identificador de recurso (URI da ID do aplicativo) do recurso, afixado com o sufixo .default.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
--secret-name -s

O nome do segredo kubernetes que contém o valor da chave primária da cadeia de conexão. Pode ser encontrado no destino do fluxo de eventos – seção "Autenticação de Chave SAS". Observação: o segredo deve estar no mesmo namespace que o ponto de extremidade de fluxo de dados kafka. Para obter mais informações sobre o formato secreto, consulte o link na descrição do comando.

Propriedade Valor
Grupo de parâmetros: SASL Authentication Arguments
--show-config

Mostrar a configuração de recurso gerada em vez de invocar a API com ela.

Propriedade Valor
Valores aceitos: false, true
--tenant-id --tid

A ID do locatário da identidade atribuída pelo usuário.

Propriedade Valor
Grupo de parâmetros: User Assigned Managed Identity Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot ops dataflow endpoint create local-mqtt

Crie ou substitua um ponto de extremidade de fluxo de dados MQTT local das Operações IoT do Azure.

Para obter mais informações sobre o ponto de extremidade de fluxo de dados MQTT local das Operações IoT do Azure, 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}]

Exemplos

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados por 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

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados usando o método de autenticação 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

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados sem autenticação.

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 configuração para criar um recurso de ponto de extremidade de fluxo de dados.

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 Exigidos

--hostname

O nome do host do agente MQTT local.

--instance -i

Nome da instância de operações de IoT.

--name -n

Nome do ponto de extremidade do fluxo de dados.

--port

O número da porta do agente MQTT local.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--aud --audience

O público-alvo do token de conta de serviço do Kubernetes (SAT).

Propriedade Valor
Grupo de parâmetros: Kubernetes Service Account Token Arguments
--auth-type

O tipo de autenticação para o ponto de extremidade do fluxo de dados. Observação: quando não especificado, o tipo de autenticação é determinado por outros parâmetros de autenticação.

Propriedade Valor
Valores aceitos: ServiceAccountToken, X509Certificate
--cea --cloud-event-attribute

As configurações do CloudEvent digitam para mapear eventos para a nuvem. Formato de mensagem diferente é exigido por configuração diferente.

Propriedade Valor
Grupo de parâmetros: Cloud Event Arguments
Valor padrão: Propagate
Valores aceitos: CreateOrRemap, Propagate
--client-id-prefix

O prefixo de ID do cliente para o cliente MQTT. Observação: alterar o prefixo da ID do cliente após a implantação das Operações de IoT pode resultar em perda de dados.

--cm --config-map-ref

Referência de mapa de configuração para o certificado de AC confiável para o ponto de extremidade Kafka/MQTT. Observação: este ConfigMap deve conter o certificado de AC no formato PEM. O ConfigMap deve estar no mesmo namespace que o recurso de fluxo de dados Kafka/MQTT.

Propriedade Valor
Grupo de parâmetros: Transport Layer Security (TLS) Arguments
Valor padrão: azure-iot-operations-aio-ca-trust-bundle
--disable-tls

O fluxo de dados usa uma conexão insegura com o agente Kafka/MQTT.

Propriedade Valor
Grupo de parâmetros: Transport Layer Security (TLS) Arguments
Valor padrão: False
Valores aceitos: false, true
--ka --keep-alive

O tempo máximo em segundos em que o cliente de fluxo de dados pode ficar ocioso antes de enviar uma mensagem PINGREQ para o agente. Valor mínimo: 0.

Propriedade Valor
Valor padrão: 60
--max-inflight-msg --mim

O número máximo de mensagens de bordo que o cliente MQTT de fluxo de dados pode ter. Valor mínimo: 0.

Propriedade Valor
Valor padrão: 100
--no-auth

Nenhuma autenticação para o ponto de extremidade.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--protocol

Protocolo a ser usado para conexões de cliente.

Propriedade Valor
Valor padrão: Mqtt
Valores aceitos: Mqtt, WebSockets
--qos

Nível de QoS (qualidade de serviço) para as mensagens MQTT. Há suporte apenas para 0 ou 1.

Propriedade Valor
Valor padrão: 1
--retain

Mantenha a configuração para especificar se o fluxo de dados deve manter o sinalizador de retenção em mensagens MQTT. Definir isso garante se o agente remoto tem ou não as mesmas mensagens retidas que o agente local.

Propriedade Valor
Valor padrão: Keep
Valores aceitos: Keep, Never
--secret-name -s

O nome do segredo do kubernetes que contém o certificado de cliente X509, a chave privada correspondente ao certificado do cliente e os certificados intermediários da cadeia de certificados do cliente. Observação: o certificado e a chave privada devem estar no formato PEM e não protegidos por senha.

Propriedade Valor
Grupo de parâmetros: X509 Authentication Arguments
--session-expiry

O intervalo de expiração da sessão em segundos para o cliente MQTT do fluxo de dados. Valor mínimo: 0.

Propriedade Valor
Valor padrão: 3600
--show-config

Mostrar a configuração de recurso gerada em vez de invocar a API com ela.

Propriedade Valor
Valores aceitos: false, true
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot ops dataflow endpoint create local-storage

Crie ou substitua um ponto de extremidade de fluxo de dados de armazenamento local.

Para obter mais informações sobre o ponto de extremidade do fluxo de dados de armazenamento 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}]

Exemplos

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados por entrada mínima.

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

Mostrar configuração para criar um recurso de ponto de extremidade de fluxo de dados.

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

Parâmetros Exigidos

--instance -i

Nome da instância de operações de IoT.

--name -n

Nome do ponto de extremidade do fluxo de dados.

--pvc-ref

O nome do PersistentVolumeClaim (PVC) a ser usado para armazenamento local. Observação: o PVC deve estar no mesmo namespace que o ponto de extremidade de fluxo de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--show-config

Mostrar a configuração de recurso gerada em vez de invocar a API com ela.

Propriedade Valor
Valores aceitos: false, true
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az iot ops dataflow endpoint create otel

Crie ou substitua um ponto de extremidade de fluxo de dados OpenTelemetry.

Para obter mais informações sobre o ponto de extremidade do fluxo de dados 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}]

Exemplos

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados por 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 configuração para criar um recurso de ponto de extremidade de fluxo de dados.

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

Crie ou substitua um recurso de ponto de extremidade de fluxo de dados usando o método de autenticação 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 Exigidos

--hostname

O nome do host da configuração de telemetria aberta.

--instance -i

Nome da instância de operações de IoT.

--name -n

Nome do ponto de extremidade do fluxo de dados.

--port

O número da porta da configuração de telemetria aberta.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--aud --audience

Público-alvo do serviço no qual se autenticar.

Propriedade Valor
Grupo de parâmetros: System Assigned Managed Identity Arguments
--auth-type

O tipo de autenticação para o ponto de extremidade do fluxo de dados. Observação: quando não especificado, o tipo de autenticação é determinado por outros parâmetros de autenticação.

Propriedade Valor
Valores aceitos: ServiceAccountToken, X509Certificate
--cm --config-map-ref

Referência de mapa de configuração para o certificado de AC confiável para o ponto de extremidade Kafka/MQTT. Observação: este ConfigMap deve conter o certificado de AC no formato PEM. O ConfigMap deve estar no mesmo namespace que o recurso de fluxo de dados Kafka/MQTT.

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

O fluxo de dados usa uma conexão insegura com o agente Kafka/MQTT.

Propriedade Valor
Grupo de parâmetros: Transport Layer Security (TLS) Arguments
Valor padrão: False
Valores aceitos: false, true
--latency -l

A latência de envio em lote em milissegundos. Valor mínimo: 0, valor máximo: 65535.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 60
--mc --message-count

Número máximo de mensagens em um lote. Valor mínimo: 0, valor máximo: 4294967295.

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
Valor padrão: 100000
--no-auth

Nenhuma autenticação para o ponto de extremidade.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--secret-name -s

O nome do segredo do kubernetes que contém o certificado de cliente X509, a chave privada correspondente ao certificado do cliente e os certificados intermediários da cadeia de certificados do cliente. Observação: o certificado e a chave privada devem estar no formato PEM e não protegidos por senha.

Propriedade Valor
Grupo de parâmetros: X509 Authentication Arguments
--show-config

Mostrar a configuração de recurso gerada em vez de invocar a API com ela.

Propriedade Valor
Valores aceitos: false, true
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False