Compartilhar via


az iot ops dataflow endpoint update

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 atualização do ponto de extremidade do fluxo de dados do az iot ops . Saiba mais sobre extensões.

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente.

Comandos

Nome Description Tipo Status
az iot ops dataflow endpoint update adls

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente para o Azure Data Lake Storage Gen2.

Extension GA
az iot ops dataflow endpoint update adx

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente para o Azure Data Explorer.

Extension GA
az iot ops dataflow endpoint update custom-kafka

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente para o agente kafka personalizado.

Extension GA
az iot ops dataflow endpoint update custom-mqtt

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente para o agente MQTT personalizado.

Extension GA
az iot ops dataflow endpoint update eventgrid

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente para a Grade de Eventos do Azure.

Extension GA
az iot ops dataflow endpoint update eventhub

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente para o namespace dos Hubs de Eventos do Azure habilitado para kafka.

Extension GA
az iot ops dataflow endpoint update fabric-onelake

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente para o Microsoft Fabric OneLake.

Extension GA
az iot ops dataflow endpoint update fabric-realtime

Atualize as propriedades de um ponto de extremidade de fluxo de dados do Microsoft Fabric Real-Time Intelligence existente.

Extension GA
az iot ops dataflow endpoint update local-mqtt

Atualize as propriedades de um ponto de extremidade de fluxo de dados MQTT local de operações de IoT do Azure existente.

Extension GA
az iot ops dataflow endpoint update local-storage

Atualize as propriedades de um ponto de extremidade de fluxo de dados de armazenamento local existente.

Extension GA
az iot ops dataflow endpoint update otel

Atualize as propriedades de um ponto de extremidade de fluxo de dados OpenTelemetry existente.

Extension GA

az iot ops dataflow endpoint update adls

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente 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.

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

Exemplos

Atualize o nome da conta de armazenamento do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Atualize para usar o método de autenticação de identidade gerenciada atribuído pelo usuário do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Parâmetros 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>.

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
--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
--sa --storage-account

O nome da conta do Azure Data Lake Storage Gen2.

--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/ para obter 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 update adx

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente 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 update adx --instance
                                        --name
                                        --resource-group
                                        [--aud --audience]
                                        [--auth-type {SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                        [--cid --client-id]
                                        [--database --db]
                                        [--host]
                                        [--latency]
                                        [--mc --message-count]
                                        [--scope]
                                        [--show-config {false, true}]
                                        [--tenant-id --tid]

Exemplos

Atualize as configurações de envio em lote do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Atualize para usar o método de autenticação de identidade gerenciada atribuído pelo sistema do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

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

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

--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
--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
--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/ para obter 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 update custom-kafka

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente 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 update custom-kafka --instance
                                                 --name
                                                 --resource-group
                                                 [--acks {All, One, Zero}]
                                                 [--aud --audience]
                                                 [--auth-type {Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                                 [--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
                                                 [--cid --client-id]
                                                 [--cm --config-map-ref]
                                                 [--compression {Gzip, Lz4, None, Snappy}]
                                                 [--db --disable-batching {false, true}]
                                                 [--dbpc --disable-broker-props-copy {false, true}]
                                                 [--disable-tls {false, true}]
                                                 [--gid --group-id]
                                                 [--hostname]
                                                 [--latency]
                                                 [--max-bytes --mb]
                                                 [--mc --message-count]
                                                 [--no-auth {false, true}]
                                                 [--partition-strategy --ps {Default, Property, Static, Topic}]
                                                 [--port]
                                                 [--sasl-type {Plain, ScramSha256, ScramSha512}]
                                                 [--scope]
                                                 [--secret-name]
                                                 [--show-config {false, true}]
                                                 [--tenant-id --tid]

Exemplos

Atualize o nome do host do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Atualize para usar o método de autenticação SASL do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Parâmetros 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>.

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

--hostname

O nome do host da configuração de host do agente 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
--max-bytes --mb

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

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
--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
--no-auth

Nenhuma autenticação para o ponto de extremidade.

Propriedade Valor
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
--port

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

--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/ para obter 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 update custom-mqtt

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente para o 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 update custom-mqtt --instance
                                                --name
                                                --resource-group
                                                [--auth-type {ServiceAccountToken, SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate}]
                                                [--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
                                                [--cid --client-id]
                                                [--client-id-prefix]
                                                [--cm --config-map-ref]
                                                [--disable-tls {false, true}]
                                                [--hostname]
                                                [--ka --keep-alive]
                                                [--max-inflight-msg --mim]
                                                [--no-auth {false, true}]
                                                [--port]
                                                [--protocol {Mqtt, WebSockets}]
                                                [--qos]
                                                [--retain {Keep, Never}]
                                                [--sami-aud --sami-audience]
                                                [--sat-aud --sat-audience]
                                                [--scope]
                                                [--secret-name]
                                                [--session-expiry]
                                                [--show-config {false, true}]
                                                [--tenant-id --tid]

Exemplos

Atualize o tipo de configuração de evento de nuvem do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Atualize para usar o método de autenticação X509 do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Parâmetros 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>.

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
Valores aceitos: false, true
--hostname

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

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

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

--no-auth

Nenhuma autenticação para o ponto de extremidade.

Propriedade Valor
Valores aceitos: false, true
--port

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

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

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

--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/ para obter 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 update eventgrid

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente 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 update eventgrid --instance
                                              --name
                                              --resource-group
                                              [--aud --audience]
                                              [--auth-type {SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate}]
                                              [--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
                                              [--cid --client-id]
                                              [--client-id-prefix]
                                              [--cm --config-map-ref]
                                              [--hostname]
                                              [--ka --keep-alive]
                                              [--max-inflight-msg --mim]
                                              [--port]
                                              [--protocol {Mqtt, WebSockets}]
                                              [--qos]
                                              [--retain {Keep, Never}]
                                              [--scope]
                                              [--secret-name]
                                              [--session-expiry]
                                              [--show-config {false, true}]
                                              [--tenant-id --tid]

Exemplos

Atualize o intervalo de expiração da sessão do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Atualize para usar o método de autenticação X509 do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

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

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

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

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

--port

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

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

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

--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/ para obter 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 update eventhub

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente 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 update eventhub --instance
                                             --name
                                             --resource-group
                                             [--acks {All, One, Zero}]
                                             [--aud --audience]
                                             [--auth-type {Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                             [--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
                                             [--cid --client-id]
                                             [--cm --config-map-ref]
                                             [--compression {Gzip, Lz4, None, Snappy}]
                                             [--db --disable-batching {false, true}]
                                             [--dbpc --disable-broker-props-copy {false, true}]
                                             [--ehns --eventhub-namespace]
                                             [--gid --group-id]
                                             [--latency]
                                             [--max-bytes --mb]
                                             [--mc --message-count]
                                             [--partition-strategy --ps {Default, Property, Static, Topic}]
                                             [--sasl-type {Plain, ScramSha256, ScramSha512}]
                                             [--scope]
                                             [--secret-name]
                                             [--show-config {false, true}]
                                             [--tenant-id --tid]

Exemplos

Atualize o tipo de compactação do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Atualize para usar o método de autenticação SASL do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Parâmetros 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>.

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
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
Valores aceitos: false, true
--ehns --eventhub-namespace

O nome do namespace dos Hubs de Eventos.

--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
--max-bytes --mb

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

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
--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
--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/ para obter 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 update fabric-onelake

Atualize as propriedades de um recurso de ponto de extremidade de fluxo de dados existente 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 update fabric-onelake --instance
                                                   --name
                                                   --resource-group
                                                   [--aud --audience]
                                                   [--auth-type {SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
                                                   [--cid --client-id]
                                                   [--lakehouse]
                                                   [--latency]
                                                   [--mc --message-count]
                                                   [--path-type --pt {Files, Tables}]
                                                   [--scope]
                                                   [--show-config {false, true}]
                                                   [--tenant-id --tid]
                                                   [--workspace]

Exemplos

Atualize o nome do lakehouse do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Atualize para usar o método de autenticação de identidade gerenciada atribuído pelo sistema do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

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

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

O nome do Lakehouse do Microsoft Fabric no workspace fornecido.

--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
--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
--path-type --pt

O tipo de caminho usado no OneLake.

Propriedade Valor
Valores aceitos: Files, Tables
--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
--workspace

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

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/ para obter 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 update fabric-realtime

Atualize as propriedades de um ponto de extremidade de fluxo de dados do Microsoft Fabric Real-Time Intelligence existente.

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

Exemplos

Atualize a estratégia de partição do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Atualize para usar o método de autenticação SASL do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Parâmetros 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>.

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

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

--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
--max-bytes --mb

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

Propriedade Valor
Grupo de parâmetros: Batching Configuration Arguments
--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
--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/ para obter 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 update local-mqtt

Atualize as propriedades de um ponto de extremidade de fluxo de dados MQTT local de operações de IoT do Azure existente.

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

Exemplos

Atualize a referência de mapa de configuração para o certificado de AUTORIDADE confiável do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Atualize para usar o método de autenticação de Token de Conta de Serviço do Kubernetes do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Parâmetros 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>.

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

O nome do host do agente MQTT local.

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

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

--no-auth

Nenhuma autenticação para o ponto de extremidade.

Propriedade Valor
Valores aceitos: false, true
--port

O número da porta do agente MQTT local.

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

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

--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/ para obter 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 update local-storage

Atualize as propriedades de um ponto de extremidade de fluxo de dados de armazenamento local existente.

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

Exemplos

Atualize a referência de PVC do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

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

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.

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

--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/ para obter 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 update otel

Atualize as propriedades de um ponto de extremidade de fluxo de dados OpenTelemetry existente.

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

Exemplos

Atualize a referência de mapa de configuração para o certificado de AUTORIDADE confiável do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

Atualize para usar o método de autenticação de Token de Conta de Serviço do Kubernetes do recurso de ponto de extremidade de fluxo de dados chamado 'myendpoint'.

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

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

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
Valores aceitos: false, true
--hostname

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

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

Nenhuma autenticação para o ponto de extremidade.

Propriedade Valor
Valores aceitos: false, true
--port

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

--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/ para obter 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