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
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
Nome da instância de Operações IoT.
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.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
Desative a representação visual do trabalho.
| Propriedade | Valor |
|---|---|
| Valores aceites: | false, true |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
az iot ops live-data enable
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
Event Grid Namespace ID do recurso ARM.
Nome da instância de Operações IoT.
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.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
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 |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
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.
Desative a representação visual do trabalho.
| Propriedade | Valor |
|---|---|
| Valores aceites: | false, true |
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 |
Â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 |
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 |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
az iot ops live-data show
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
Nome da instância de Operações IoT.
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.
Desative a representação visual do trabalho.
| Propriedade | Valor |
|---|---|
| Valores aceites: | false, true |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |