az iot ops live-data

Note

Esta referência faz parte da extensão azure-iot-ops para o CLI do Azure (versão 2.70.0 ou superior). A extensão instala-se automaticamente na primeira vez que executares um comando live-data do iot ops do Arizona . Saiba mais sobre extensões.

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Configuração da infraestrutura de dados em tempo real para uma instância de Operações IoT.

Requer um tempo de execução de pré-visualização. Ativar requer um tempo de execução pronto; mostrar e desativar permanecem disponíveis para diagnóstico e limpeza de tempos de execução de pré-visualização pouco saudáveis.

Comandos

Nome Descrição Tipo Estado
az iot ops live-data disable

Desativar dados em tempo real para uma instância de Operações IoT.

Extension Preview
az iot ops live-data enable

Ative dados em tempo real para uma instância de Operações IoT.

Extension Preview
az iot ops live-data show

Mostrar configuração de dados em tempo real para uma instância de Operações IoT.

Extension Preview

az iot ops live-data disable

Pré-visualizar

O grupo de comando 'iot ops live-data' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Desativar dados em tempo real para uma instância de Operações IoT.

Desmonta o perfil dedicado de fluxo de dados, o endpoint de dataflow EG e o espaço de tópicos de observabilidade, removendo depois a entrada do endpoint de observabilidade desta instância do namespace do Registo de Dispositivos por último, para que uma desativação interrompida possa ser executada em segurança. Preserva a observabilidade em todo o namespace, as entradas de flag e endpoint pertencentes a outras instâncias, mesmo quando a entrada desta instância é a última removida. Os IDs de recursos de localização personalizados são correspondidos de forma insensível a maiúsculas e minúsculas.

A limpeza continua para recursos detidos pela instância se a referência ADR ou o namespace estiver em falta. Se o espaço de nomes da Grelha de Eventos não puder ser localizado, um aviso identifica o espaço de tópico que pode necessitar de limpeza manual.

As atribuições de papéis de identidade gerida com escopo de espaço de nomes em grelha de eventos são preservadas; as atribuições de identidade gerida com âmbito de espaço de tópicos são removidas juntamente com o espaço de tópicos. As atribuições de leitores criadas para --user-object-ids são sempre atribuídas ao namespace do Registo de Dispositivos, não são afetadas pelo --ra-scope e são preservadas. Use os IDs de atribuição devolvidos por ativar se for necessária uma limpeza explícita.

az iot ops live-data disable --instance
                             --resource-group
                             [--acquire-policy-token]
                             [--change-reference]
                             [--no-progress {false, true}]
                             [--yes {false, true}]

Exemplos

Desative os Dados em Tempo Real para uma instância.

az iot ops live-data disable --instance myinstance -g myresourcegroup

Desative os Dados em Tempo Real sem que apareça o pedido de confirmação.

az iot ops live-data disable --instance myinstance -g myresourcegroup --yes

Parâmetros Obrigatórios

--instance -i -n

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

--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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--no-progress

Desative a representação visual do trabalho.

Propriedade Valor
Valores aceites: false, true
--yes -y

Confirme [s]es sem um prompt. Útil para cenários de CI e automação.

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

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor predefinido: False

az iot ops live-data enable

Pré-visualizar

O grupo de comando 'iot ops live-data' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Ative dados em tempo real para uma instância de Operações IoT.

Provisiona e configura a infraestrutura partilhada ao nível de instância necessária para Dados em Tempo Real em três domínios:

  • Espaço de Nomes da Grelha de Eventos: um espaço temático de observabilidade.
  • Instância de Operações IoT: um perfil dedicado de fluxo de dados e um endpoint de fluxo de dados MQTT, por exemplo.
  • Espaço de Nomes do Registo de Dispositivos: a identidade de saída e a entrada do endpoint de observabilidade por instância (indexada pela localização personalizada da instância).

O comando é idempotente. A re-execução converge para o estado desejado sem sobrescrever entradas não relacionadas. Define a observabilidade do namespace ativada como verdadeira e adiciona a entrada do endpoint de observabilidade da instância. A ativação por instância é determinada por essa entrada e configuração de recursos de suporte, não pela flag a nível do namespace. Os pré-requisitos de ADR são validados antes de os recursos serem criados. Os modelos existentes de tópicos de Live Data e as definições do perfil de dataflow são reconciliados ao reativar. A identidade de saída da ADR abrange todo o namespace. Se outros endpoints de observabilidade ou gestão partilharem o namespace, reutilize a sua identidade existente; alterá-lo é rejeitado para evitar perturbar esses endpoints.

Por defeito, as atribuições de papéis (Event Grid TopicSpaces Publisher para a identidade da instância e Subscriber para a identidade do namespace ADR) são criadas no âmbito do namespace Event Grid. Use --ra-scope topic-space para atribuições de menor privilégio com âmbito para o topic space, ou --skip-ra para saltar a criação de atribuição de funções.

Use --user-object-ids para conceder o Leitor diretamente a um ou mais utilizadores Microsoft Entra a partir do inquilino de recursos no âmbito do espaço de nomes do Registo de Dispositivos. Estas atribuições são aditivas, idempotentes, não afetadas por --ra-scope, e preservadas em desabilitação. O comando devolve os IDs de atribuição para limpeza explícita. --Skip-ra tem prioridade e salta estas tarefas. Atribuições individuais de utilizadores são necessárias durante a Pré-visualização Pública quando a autorização baseada em grupos não está disponível.

az iot ops live-data enable --eg-resource-id
                            --instance
                            --resource-group
                            [--acquire-policy-token]
                            [--adr-role-ids]
                            [--change-reference]
                            [--mi-user-assigned]
                            [--no-progress {false, true}]
                            [--ops-role-ids]
                            [--ra-scope {namespace, topic-space}]
                            [--skip-ra {false, true}]
                            [--user-object-ids]

Exemplos

Permitir Dados Em Tempo Real usando uma identidade gerida atribuída pelo sistema e papéis predefinidos.

az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID

Ativar Dados em Tempo Real usando uma identidade gerida atribuída pelo utilizador para autenticação de saída.

az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --mi-user-assigned $UA_MI_RESOURCE_ID

Permitir Dados Em Tempo Real com atribuições de funções com privilégio mínimo e âmbito de espaço de tópicos.

az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --ra-scope topic-space

Ative os Dados em Tempo Real e conceda o Reader diretamente aos utilizadores da Microsoft Entra.

az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --user-object-ids $USER_OBJECT_ID_1 $USER_OBJECT_ID_2

Ative Dados em Tempo Real e ignore as atribuições de funções.

az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --skip-ra

Parâmetros Obrigatórios

--eg-resource-id

Event Grid Namespace ID do recurso ARM.

--instance -i -n

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

--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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--adr-role-ids

Ids de papel personalizados para a identidade do namespace ADR (Subscriber) contra o namespace EG. Predefinido: 'Assinante Event Grid TopicSpaces'.

Propriedade Valor
Grupo de parâmetros: Role Assignment Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--mi-user-assigned

Id de recurso de identidade gerida atribuído pelo utilizador para o endpoint de fluxo de dados EG e identidade de saída do espaço de nomes ADR. Padrão: identidade gerida atribuída pelo sistema.

--no-progress

Desative a representação visual do trabalho.

Propriedade Valor
Valores aceites: false, true
--ops-role-ids

Ids de papel personalizados para a identidade da instância AIO (Publisher) contra o espaço de nomes EG. Predefinido: 'Event Grid TopicSpaces Publisher'.

Propriedade Valor
Grupo de parâmetros: Role Assignment Arguments
--ra-scope

Âmbito para atribuições de funções na Grade de Eventos. 'namespace' (por defeito) atribui no namespace EG e é preservado na desativação; 'topic-space' atribui no recurso de topic-space (privilégio mínimo) e é removido com o topic space em desabilitar.

Propriedade Valor
Grupo de parâmetros: Role Assignment Arguments
Valores aceites: namespace, topic-space
--skip-ra

Quando usada, a etapa de atribuição de função da operação será ignorada.

Propriedade Valor
Grupo de parâmetros: Role Assignment Arguments
Valores aceites: false, true
--user-object-ids

Microsoft Entra IDs de objeto de utilizador a partir do resource tenant para conceder o Reader no espaço de nomes do Registo de Dispositivos. As atribuições são aditivas e preservadas em desabilitar. Ignorado quando se usa --skip-ra.

Propriedade Valor
Grupo de parâmetros: Role Assignment Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor predefinido: False

az iot ops live-data show

Pré-visualizar

O grupo de comando 'iot ops live-data' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Mostrar configuração de dados em tempo real para uma instância de Operações IoT.

Reporta a configuração dos dados em tempo real e o estado dos recursos através do namespace do Registo de Dispositivos, Grade de Eventos e recursos de fluxo de dados IoT Operations. A flag ativada de nível superior é verdadeira apenas quando a entrada do endpoint de observabilidade desta instância está presente e todos os recursos de suporte estão presentes. A flag de ativação de observabilidade a nível de namespace é reportada para informação e não determina a ativação por instância. Os modelos de tópicos, definições de perfil dedicado, tipo de endpoint, host, autenticação, prefixo do cliente-ID e modo TLS também devem corresponder à configuração de Dados em Tempo Real. O estado do endpoint inclui uma flag configurada. Para a autenticação atribuída pelo utilizador, a verificação também lê os IDs do cliente e do tenant da identidade gerida referenciada. O estado do namespace do Registo de Dispositivos inclui userReaderAssignments com IDs principal e assignment para atribuições diretas de Reader do utilizador no âmbito do namespace, incluindo atribuições criadas fora da habilitação Live Data. As atribuições herdadas e de grupo são excluídas. Ler esta lista requer a Microsoft. Autorização/roleAssignments/read; erros de autorização ou serviço são apresentados em vez de reportados como uma lista vazia.

az iot ops live-data show --instance
                          --resource-group
                          [--no-progress {false, true}]

Exemplos

Mostrar configuração de dados em tempo real para uma instância.

az iot ops live-data show --instance myinstance -g myresourcegroup

Parâmetros Obrigatórios

--instance -i -n

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

--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 tornar-se necessários para que o comando seja executado com êxito.

--no-progress

Desative a representação visual do trabalho.

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

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor predefinido: False