az iot ops

Observação

Essa referência faz parte da extensão azure-iot-ops para a CLI do Azure (versão 2.53.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az iot ops . Saiba mais sobre extensões.

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerencie as operações do Azure IoT.

O Azure IoT Operations é um conjunto de serviços Kubernetes primários altamente alinhados, mas fracamente acoplados, que permitem agregar dados de ativos locais em um Agente MQTT de nível industrial, adicionar computação de borda e configurar o fluxo de dados bidirecional com uma variedade de serviços na nuvem.

Por padrão, os comandos da CLI de operações de IoT verificarão periodicamente se uma nova versão de extensão está disponível. Esse comportamento pode ser desativado com az config set iotops.check_latest=falseo .

Comandos

Nome	Description	Tipo	Status
az iot ops asset	Gestão de ativos.	Extensão	Visualizar
az iot ops asset create	Crie um ativo.	Extensão	Visualizar
az iot ops asset dataset	Gerencie conjuntos de dados em um ativo.	Extensão	Visualizar
az iot ops asset dataset list	Listar conjuntos de dados em um ativo.	Extensão	Visualizar
az iot ops asset dataset point	Gerencie pontos de dados em um conjunto de dados de ativos.	Extensão	Visualizar
az iot ops asset dataset point add	Adicione um ponto de dados a um conjunto de dados de ativos.	Extensão	Visualizar
az iot ops asset dataset point export	Exporte pontos de dados em um conjunto de dados de ativos.	Extensão	Visualizar
az iot ops asset dataset point import	Importe pontos de dados em um conjunto de dados de ativos.	Extensão	Visualizar
az iot ops asset dataset point list	Listar pontos de dados em um conjunto de dados de ativos.	Extensão	Visualizar
az iot ops asset dataset point remove	Remova um ponto de dados em um conjunto de dados de ativos.	Extensão	Visualizar
az iot ops asset dataset show	Mostrar um conjunto de dados dentro de um ativo.	Extensão	Visualizar
az iot ops asset delete	Exclua um ativo.	Extensão	Visualizar
az iot ops asset endpoint	Gerencie perfis de endpoint de ativos.	Extensão	Visualizar
az iot ops asset endpoint create	Crie perfis de endpoint de ativos.	Extensão	Visualizar
az iot ops asset endpoint create opcua	Crie um perfil de endpoint de ativo com um conector OPCUA.	Extensão	Visualizar
az iot ops asset endpoint delete	Exclua um perfil de endpoint de ativo.	Extensão	Visualizar
az iot ops asset endpoint query	Consulte o Resource Graph para obter perfis de endpoint de ativos.	Extensão	Visualizar
az iot ops asset endpoint show	Mostrar um perfil de endpoint de ativo.	Extensão	Visualizar
az iot ops asset endpoint update	Atualize um perfil de endpoint de ativo.	Extensão	Visualizar
az iot ops asset event	Gerencie eventos em um ativo.	Extensão	Visualizar
az iot ops asset event add	Adicione um evento a um ativo.	Extensão	Visualizar
az iot ops asset event export	Exportar eventos em um ativo.	Extensão	Visualizar
az iot ops asset event import	Importe eventos em um ativo.	Extensão	Visualizar
az iot ops asset event list	Listar eventos em um ativo.	Extensão	Visualizar
az iot ops asset event remove	Remova um evento em um ativo.	Extensão	Visualizar
az iot ops asset query	Consulte o Resource Graph para ativos.	Extensão	Visualizar
az iot ops asset show	Mostrar um ativo.	Extensão	Visualizar
az iot ops asset update	Atualize um ativo.	Extensão	Visualizar
az iot ops broker	Gerenciamento de corretor Mqtt.	Extensão	Visualizar
az iot ops broker authn	Gerenciamento de autenticação do agente.	Extensão	Visualizar
az iot ops broker authn delete	Exclua um recurso de autenticação do agente mqtt.	Extensão	Visualizar
az iot ops broker authn list	Listar os recursos de autenticação do agente mqtt associados a uma instância.	Extensão	Visualizar
az iot ops broker authn show	Mostrar detalhes de um recurso de autenticação do agente mqtt.	Extensão	Visualizar
az iot ops broker authz	Gerenciamento de autorização de corretores.	Extensão	Visualizar
az iot ops broker authz delete	Exclua um recurso de autorização do agente mqtt.	Extensão	Visualizar
az iot ops broker authz list	Listar os recursos de autorização do broker mqtt associados a uma instância.	Extensão	Visualizar
az iot ops broker authz show	Mostrar detalhes de um recurso de autorização do agente mqtt.	Extensão	Visualizar
az iot ops broker delete	Exclua um agente mqtt.	Extensão	Visualizar
az iot ops broker list	Listar agentes mqtt associados a uma instância.	Extensão	Visualizar
az iot ops broker listener	Gerenciamento de ouvintes de agentes.	Extensão	Visualizar
az iot ops broker listener delete	Exclua um ouvinte do agente mqtt.	Extensão	Visualizar
az iot ops broker listener list	Listar listeners do agente mqtt associados a um agente.	Extensão	Visualizar
az iot ops broker listener show	Mostrar detalhes de um ouvinte do agente mqtt.	Extensão	Visualizar
az iot ops broker show	Mostrar detalhes de um broker mqtt.	Extensão	Visualizar
az iot ops broker stats	Mostrar estatísticas de execução do dmqtt.	Extensão	Visualizar
az iot ops check	Avalie a preparação do lado do cluster e a integridade do tempo de execução dos serviços de operações de IoT implantados.	Extensão	Visualizar
az iot ops connector	Gerenciamento de conectores.	Extensão	Visualizar
az iot ops connector opcua	Gerenciamento de conectores OPC UA.	Extensão	Visualizar
az iot ops connector opcua client	Gerencie o certificado de instância de aplicativo cliente de nível empresarial para o OPC UA Broker.	Extensão	Visualizar
az iot ops connector opcua client add	Adicione um certificado de instância de aplicativo cliente de nível empresarial.	Extensão	Visualizar
az iot ops connector opcua issuer	Gerencie certificados de emissor para o OPC UA Broker.	Extensão	Visualizar
az iot ops connector opcua issuer add	Adicione um certificado de emissor à lista de certificados de emissor do OPC UA Broker.	Extensão	Visualizar
az iot ops connector opcua trust	Gerencie certificados confiáveis para o OPC UA Broker.	Extensão	Visualizar
az iot ops connector opcua trust add	Adicione um certificado confiável à lista de certificados confiáveis do OPC UA Broker.	Extensão	Visualizar
az iot ops create	Crie uma instância de Operações de IoT.	Extensão	Visualizar
az iot ops dataflow	Gerenciamento de fluxo de dados.	Extensão	Visualizar
az iot ops dataflow endpoint	Gerenciamento de endpoint de fluxo de dados.	Extensão	Visualizar
az iot ops dataflow endpoint list	Listar os recursos de ponto de extremidade de fluxo de dados associados a uma instância.	Extensão	Visualizar
az iot ops dataflow endpoint show	Mostrar detalhes de um recurso de ponto de extremidade de fluxo de dados.	Extensão	Visualizar
az iot ops dataflow list	Listar fluxos de dados associados a um perfil de fluxo de dados.	Extensão	Visualizar
az iot ops dataflow profile	Gerenciamento de perfil de fluxo de dados.	Extensão	Visualizar
az iot ops dataflow profile list	Listar perfis de fluxo de dados associados a uma instância.	Extensão	Visualizar
az iot ops dataflow profile show	Mostrar detalhes de um perfil de fluxo de dados.	Extensão	Visualizar
az iot ops dataflow show	Mostrar detalhes de um fluxo de dados associado a um perfil de fluxo de dados.	Extensão	Visualizar
az iot ops delete	Exclua as operações de IoT do cluster.	Extensão	Visualizar
az iot ops identity	Gerenciamento de identidade de instância.	Extensão	Visualizar
az iot ops identity assign	Atribua uma identidade gerenciada atribuída pelo usuário à instância.	Extensão	Visualizar
az iot ops identity remove	Remova uma identidade gerenciada atribuída pelo usuário da instância.	Extensão	Visualizar
az iot ops identity show	Mostre as identidades da instância.	Extensão	Visualizar
az iot ops init	Inicialize o cluster habilitado para Arc para implantação de operações de IoT.	Extensão	Visualizar
az iot ops list	Listar instâncias de operações de IoT.	Extensão	Visualizar
az iot ops schema	Gerenciamento de esquema e registro.	Extensão	Visualizar
az iot ops schema create	Crie um esquema dentro de um registro de esquema.	Extensão	Visualizar
az iot ops schema delete	Exclua um esquema de destino em um registro de esquema.	Extensão	Visualizar
az iot ops schema list	Listar esquemas em um registro de esquema.	Extensão	Visualizar
az iot ops schema registry	Gerenciamento de registro de esquema.	Extensão	Visualizar
az iot ops schema registry create	Criar um registro de esquema	Extensão	Visualizar
az iot ops schema registry delete	Exclua um registro de esquema de destino.	Extensão	Visualizar
az iot ops schema registry list	Listar registros de esquema em um grupo de recursos ou assinatura.	Extensão	Visualizar
az iot ops schema registry show	Mostrar detalhes de um registro de esquema.	Extensão	Visualizar
az iot ops schema show	Mostrar detalhes de um esquema em um registro de esquema.	Extensão	Visualizar
az iot ops schema show-dataflow-refs	Mostre as referências de esquema usadas para fluxos de dados.	Extensão	Visualizar
az iot ops schema version	Gerenciamento de versão de esquema.	Extensão	Visualizar
az iot ops schema version add	Adicione uma versão de esquema a um esquema.	Extensão	Visualizar
az iot ops schema version list	Listar versões de esquema para um esquema específico.	Extensão	Visualizar
az iot ops schema version remove	Remova uma versão do esquema de destino.	Extensão	Visualizar
az iot ops schema version show	Mostrar detalhes de uma versão do esquema.	Extensão	Visualizar
az iot ops secretsync	Gerenciamento de sincronização de segredo de instância.	Extensão	Visualizar
az iot ops secretsync disable	Desative a sincronização secreta para uma instância.	Extensão	Visualizar
az iot ops secretsync enable	Ative a sincronização secreta para uma instância.	Extensão	Visualizar
az iot ops secretsync list	Liste as configurações de sincronização secreta associadas a uma instância.	Extensão	Visualizar
az iot ops show	Mostrar uma instância de operações de IoT.	Extensão	Visualizar
az iot ops support	As operações de IoT dão suporte às operações.	Extensão	Visualizar
az iot ops support create-bundle	Cria um arquivo zip de pacote de suporte padrão para uso em solução de problemas e diagnósticos.	Extensão	Visualizar
az iot ops update	Atualize uma instância de operações de IoT.	Extensão	Visualizar
az iot ops upgrade	Atualize uma instância de operações de IoT para a versão mais recente.	Extensão	Visualizar
az iot ops verify-host	Executa um conjunto de verificações de host de cluster para compatibilidade de implantação de operações de IoT.	Extensão	Visualizar

az iot ops check

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Avalie a preparação do lado do cluster e a integridade do tempo de execução dos serviços de operações de IoT implantados.

Por padrão, o comando mostra uma exibição resumida amigável para humanos de alto nível de todos os serviços. Use a opção '--svc' para especificar verificações para um único serviço e configurar o detalhamento por meio do --detail-level argumento. Observação: a filtragem de tipo de recurso (--resources) e nome (--resource-name) só pode ser usada com o argumento '--svc'.

{APIs de serviço suportadas}

• deviceregistry.microsoft.com/[v1beta2]
• mqttbroker.iotoperations.azure.com/[v1beta1]
• opcuabroker.iotoperations.azure.com/[v1beta1]
• connectivity.iotoperations.azure.com/[v1beta1]

Para obter mais informações sobre os requisitos do cluster, consulte https://aka.ms/iot-ops-cluster-requirements.

az iot ops check [--as-object {false, true}]
                 [--context]
                 [--detail-level {0, 1, 2}]
                 [--ops-service {akri, broker, dataflow, deviceregistry, opcua}]
                 [--post {false, true}]
                 [--pre {false, true}]
                 [--resource-name]
                 [--resources {asset, assetendpointprofile, assettype, broker, brokerlistener, dataflow, dataflowendpoint, dataflowprofile}]

Exemplos

Uso básico. Verifica a integridade geral das operações de IoT com saída resumida.

az iot ops check

Verifica a integridade e a configuração do serviço 'broker' com saída detalhada.

az iot ops check --svc broker --detail-level 1

Avalie apenas o serviço de 'fluxo de dados' com saída otimizada para CI.

az iot ops check --svc dataflow --as-object

Verifica a integridade do 'deviceregistry' com saída detalhada, mas restringe os resultados aos recursos de 'ativo'.

az iot ops check --svc deviceregistry --detail-level 2 --resources asset

Use o nome do recurso para restringir os resultados a recursos de 'ativo' com o prefixo de nome 'my-asset-'

az iot ops check --svc deviceregistry --resources asset --resource-name 'my-asset-*'

Parâmetros Opcionais

--as-object

Produza o conteúdo e as validações de verificação em uma estrutura de dados amigável de CI.

Valores aceitos: false, true

--context

Kubeconfig nome de contexto a ser usado para comunicação de cluster k8s. Se nenhum contexto for fornecido, current_context será usado.

--detail-level

Controla o nível de detalhe exibido na saída de verificação. Escolha 0 para uma exibição de resumo (saída mínima), 1 para uma exibição detalhada (informações mais abrangentes) ou 2 para uma exibição detalhada (todas as informações disponíveis).

Valores aceitos: 0, 1, 2

Valor padrão: 0

--ops-service --svc

A implantação do serviço IoT Operations que será avaliada.

Valores aceitos: akri, broker, dataflow, deviceregistry, opcua

--post

Execute verificações pós-implantação.

Valores aceitos: false, true

--pre

Execute verificações de pré-requisitos para determinar se os requisitos mínimos de uma implantação de serviço foram atendidos.

Valores aceitos: false, true

--resource-name --rn

Execute verificações apenas para o nome do recurso específico. O nome diferencia maiúsculas de minúsculas. Os padrões globais '' e '?' são suportados. Nota: Apenas caracteres alfanuméricos, hífens, '?' e '' são permitidos.

--resources

Execute verificações apenas em tipos de recursos específicos. Use valores separados por espaço.

Valores aceitos: asset, assetendpointprofile, assettype, broker, brokerlistener, dataflow, dataflowendpoint, dataflowprofile

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops create

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie uma instância de Operações de IoT.

Uma execução bem-sucedida de init é necessária antes de executar este comando.

O resultado do comando fornece uma instância de operações de IoT com um conjunto de recursos padrão configurados para função coesa.

az iot ops create --cluster
                  --name
                  --resource-group
                  --sr-resource-id
                  [--add-insecure-listener {false, true}]
                  [--bp]
                  [--br]
                  [--broker-backend-workers]
                  [--broker-config-file]
                  [--broker-frontend-replicas]
                  [--broker-frontend-workers]
                  [--broker-listener-type {ClusterIp, LoadBalancer, NodePort}]
                  [--broker-mem-profile {High, Low, Medium, Tiny}]
                  [--cluster-namespace]
                  [--custom-location]
                  [--description]
                  [--df-profile-instances]
                  [--enable-rsync {false, true}]
                  [--kubernetes-distro {K3s, K8s, MicroK8s}]
                  [--location]
                  [--no-progress {false, true}]
                  [--ops-config]
                  [--ops-version]
                  [--runtime-socket]
                  [--tags]
                  [--trust-settings]

Exemplos

Crie a instância de destino com entrada mínima.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID

O exemplo a seguir adiciona personalização ao recurso de instância do agente padrão, bem como uma descrição e tags de instância.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --broker-mem-profile High --broker-backend-workers 4 --description 'Contoso Factory' --tags tier=testX1

Este exemplo mostra a implantação de um ouvinte de agente inseguro adicional (sem authn ou authz) configurado para a porta 1883 do balanceador de carga do tipo de serviço. Útil para testes e/ou demonstrações. Não use a opção insegura na produção.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --add-insecure-listener

Este formulário mostra como habilitar a sincronização de recursos para a implantação da instância. Para habilitar a atribuição de função de sincronização de recursos, a gravação é necessária no grupo de recursos de destino.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --enable-rsync

Este exemplo destaca as configurações de confiança para uma configuração de cert-manager fornecida pelo usuário. Observe que o cluster deve ter sido inicializado com '--user-trust' e uma implantação de gerenciador de certificados de usuário deve estar presente.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --trust-settings configMapName=example-bundle configMapKey=trust-bundle.pem issuerKind=ClusterIssuer issuerName=trust-manager-selfsigned-issuer

Parâmetros Exigidos

--cluster

Nome do cluster de destino para implantação de operações de IoT.

--name -n

Nome da instância de operações de IoT. Um nome de instância deve ser fornecido para implantar uma instância durante a orquestração de inicialização.

--resource-group -g

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

--sr-resource-id

A ID do recurso de registro de esquema a ser usada com o IoT Operations.

Parâmetros Opcionais

--add-insecure-listener

Quando habilitada, a implantação do agente mqtt incluirá um ouvinte do tipo de serviço LoadBalancer, vinculado à porta 1883 sem authN ou authZ. Somente para cargas de trabalho que não são de produção.

Valores aceitos: false, true

--bp --broker-backend-part

Partições de back-end do agente Mqtt. Valor mínimo: 1, valor máximo: 16.

Valor padrão: 2

--br --broker-backend-rf

Fator de redundância de back-end do corretor Mqtt. Valor mínimo: 1, valor máximo: 5.

Valor padrão: 2

--broker-backend-workers --bw

Trabalhadores de back-end do corretor Mqtt. Valor mínimo: 1, valor máximo: 16.

Valor padrão: 2

--broker-config-file

Caminho para um arquivo json com propriedades de configuração do broker personalizadas. O conteúdo da configuração do arquivo é usado sobre parâmetros de configuração do agente individuais. Útil para cenários avançados. O formato esperado é descrito em https://aka.ms/aziotops-broker-config.

--broker-frontend-replicas --fr

Réplicas de front-end do agente Mqtt. Valor mínimo: 1, valor máximo: 16.

Valor padrão: 2

--broker-frontend-workers --fw

Trabalhadores de front-end do corretor Mqtt. Valor mínimo: 1, valor máximo: 16.

Valor padrão: 2

--broker-listener-type --lt

Tipo de serviço associado ao listener do broker mqtt padrão.

Valores aceitos: ClusterIp, LoadBalancer, NodePort

Valor padrão: ClusterIp

--broker-mem-profile --mp

Perfil de memória do agente Mqtt.

Valores aceitos: High, Low, Medium, Tiny

Valor padrão: Medium

--cluster-namespace

O namespace de cluster no qual a infraestrutura de operações de IoT será implantada. Precisa estar em minúsculas.

Valor padrão: azure-iot-operations

--custom-location

O nome do local personalizado correspondente à implantação do IoT Operations. O padrão está no formato 'location-{hash(5)}'.

--description

Descrição da instância de Operações de IoT.

--df-profile-instances

A contagem de instâncias associada ao perfil de fluxo de dados padrão.

Valor padrão: 1

--enable-rsync

As regras de sincronização de recursos serão incluídas na implantação do IoT Operations.

Valores aceitos: false, true

--kubernetes-distro

A distribuição do Kubernetes a ser usada para a configuração do Akri. A distribuição selecionada implica o caminho de soquete de tempo de execução do contêiner padrão quando nenhum valor --runtime-socket é fornecido.

Valores aceitos: K3s, K8s, MicroK8s

Valor padrão: K8s

--location

A região que será usada para garantia de recursos provisionados. Se não for fornecido, o local do cluster conectado será usado.

--no-progress

Desative a representação visual do trabalho.

Valores aceitos: false, true

--ops-config

Configuração personalizada da extensão de arco de operações de IoT. O formato é um par chave=valor separado por espaço. --ops-config pode ser usado uma ou mais vezes. Para casos de uso avançados.

--ops-version

Preterido

O argumento 'ops_version' foi descontinuado e será removido em uma versão futura.

Use para substituir a versão interna da extensão de arco de operações de IoT.

--runtime-socket

O caminho do nó padrão do soquete de runtime do contêiner. Se não for fornecido (padrão), o caminho do soquete será determinado por --kubernetes-distro.

--tags

Tags de instância. Recipiente de propriedades em pares de valores-chave com o seguinte formato: a=b c=d. Use --tags "" para remover todas as tags.

--trust-settings

Configurações para o pacote de confiança fornecido pelo usuário. Usado para o componente TLS. O formato é um par chave=valor separado por espaço. As seguintes chaves são necessárias: configMapKey, issuerKind, configMapName, issuerName. Se não for usado, um pacote de confiança autoassinado fornecido pelo sistema será configurado.

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops delete

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Exclua as operações de IoT do cluster.

O nome da instância ou do cluster deve ser fornecido.

A operação usa o Azure Resource Graph para determinar os recursos correlacionados. O Resource Graph sendo eventualmente consistente não garante um estado sincronizado no momento da execução.

az iot ops delete --resource-group
                  [--cluster]
                  [--force {false, true}]
                  [--include-deps {false, true}]
                  [--name]
                  [--no-progress {false, true}]
                  [--yes {false, true}]

Exemplos

Entrada mínima para exclusão completa.

az iot ops delete -n myinstance -g myresourcegroup

Ignore o prompt de confirmação e continue com o processo de exclusão. Útil para cenários de CI.

az iot ops delete -n myinstance -g myresourcegroup -y

Forçar exclusão independentemente dos avisos. Pode levar a erros.

az iot ops delete -n myinstance -g myresourcegroup --force

Use o nome do cluster em vez da instância para pesquisa.

az iot ops delete --cluster mycluster -g myresourcegroup

Aplicação inversa de init.

az iot ops delete -n myinstance -g myresourcegroup --include-deps

Parâmetros Exigidos

--resource-group -g

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

Parâmetros Opcionais

--cluster

Nome do cluster de destino para exclusão de operações de IoT.

--force

Force a operação a ser executada.

Valores aceitos: false, true

--include-deps

Indica que o comando deve remover as dependências de operações de IoT. Essa opção destina-se a reverter a aplicação de init.

Valores aceitos: false, true

--name -n

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

--no-progress

Desative a representação visual do trabalho.

Valores aceitos: false, true

--yes -y

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

Valores aceitos: false, true

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops init

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Inicialize o cluster habilitado para Arc para implantação de operações de IoT.

Um cluster habilitado para Arc é necessário para implantar operações de IoT. Consulte o recurso a seguir para obter mais informações https://aka.ms/aziotops-arcconnect.

A operação de inicialização fará o trabalho na instalação e configuração de uma camada de base de serviços de borda necessários para a implantação de operações de IoT.

Após a instalação da camada de base, o az iot ops create comando deve ser usado para implantar uma instância.

az iot ops init --cluster
                --resource-group
                [--enable-fault-tolerance {false, true}]
                [--ensure-latest {false, true}]
                [--no-progress {false, true}]
                [--user-trust {false, true}]

Exemplos

Uso com entrada mínima. Este formulário implantará a camada de base de Operações de IoT.

az iot ops init --cluster mycluster -g myresourcegroup

Semelhante ao exemplo anterior, mas com a tolerância a falhas do Arc Container Storage habilitada (requer pelo menos 3 nós).

az iot ops init --cluster mycluster -g myresourcegroup --enable-fault-tolerance

Este exemplo destaca a habilitação das configurações de confiança do usuário para uma configuração personalizada do cert-manager. Isso ignorará a implantação do sistema cert-manager e trust-manager.

az iot ops init --cluster mycluster -g myresourcegroup --user-trust

Parâmetros Exigidos

--cluster

Nome do cluster de destino para implantação de operações de 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

--enable-fault-tolerance

Habilite a tolerância a falhas para o Armazenamento de Contêineres do Azure Arc. São necessários pelo menos 3 nós de cluster.

Valores aceitos: false, true

--ensure-latest

Verifique se a CLI do IoT Ops mais recente está sendo usada, gerando um erro se uma atualização estiver disponível.

Valores aceitos: false, true

--no-progress

Desative a representação visual do trabalho.

Valores aceitos: false, true

--user-trust --ut

Ignore a implantação do sistema cert-manager e trust-manager em favor de uma configuração fornecida pelo usuário.

Valores aceitos: false, true

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops list

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Listar instâncias de operações de IoT.

Use --query com a sintaxe JMESPath desejada para consultar o resultado.

az iot ops list [--resource-group]

Exemplos

Liste todas as instâncias na assinatura.

az iot ops list

Listar todas as instâncias de um grupo de recursos específico.

az iot ops list -g myresourcegroup

Liste as instâncias na assinatura que têm um valor de tag específico.

az iot ops list -g myresourcegroup --query "[?tags.env == 'prod']"

Parâmetros Opcionais

--resource-group -g

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

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops show

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Mostrar uma instância de operações de IoT.

Opcionalmente, o comando pode gerar uma estrutura de árvore de recursos associados que representam a implantação de operações de IoT no cluster de suporte. Se esse comando falhar, use az iot ops upgrade para atualizar sua instância para a versão mais recente antes de continuar.

az iot ops show --name
                --resource-group
                [--tree {false, true}]

Exemplos

Uso básico para mostrar uma instância.

az iot ops show --name myinstance -g myresourcegroup

Produza uma estrutura de árvore de recursos associados que representam a implantação de operações de IoT.

az iot ops show --name myinstance -g myresourcegroup --tree

Parâmetros Exigidos

--name -n

Nome da instância de operações de 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

--tree

Use para visualizar a implantação de operações de IoT no cluster de suporte.

Valores aceitos: false, true

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops update

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualize uma instância de operações de IoT.

Atualmente, as tags e a descrição da instância podem ser atualizadas. Se você quiser atualizar sua instância para uma versão mais recente, use-a az iot ops upgrade em vez disso.

az iot ops update --name
                  --resource-group
                  [--description]
                  [--tags]

Exemplos

Atualize as tags de instância. Isso é equivalente a uma substituição.

az iot ops update --name myinstance -g myresourcegroup --tags a=b c=d

Remova as tags de instância.

az iot ops update --name myinstance -g myresourcegroup --tags ""

Atualize a descrição da instância.

az iot ops update --name myinstance -g myresourcegroup --desc "Fabrikam Widget Factory B42"

Parâmetros Exigidos

--name -n

Nome da instância de operações de 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

--description

Descrição da instância de Operações de IoT.

--tags

Tags de instância. Recipiente de propriedades em pares de valores-chave com o seguinte formato: a=b c=d. Use --tags "" para remover todas as tags.

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops upgrade

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualize uma instância de operações de IoT para a versão mais recente.

AVISO: Esse comando pode falhar e exigir que você exclua e recrie o cluster e a instância.

Atualize uma instância de IoT Operations, incluindo a atualização das extensões para as versões mais recentes. Use este comando se az iot ops show comandos semelhantes estiverem falhando.

A ID do recurso do registro de esquema é um parâmetro opcional e pode ser necessária em cenários específicos.

az iot ops upgrade --name
                   --resource-group
                   [--no-progress {false, true}]
                   [--sr-resource-id]
                   [--yes {false, true}]

Exemplos

Atualize a instância com o mínimo de entradas.

az iot ops upgrade --name myinstance -g myresourcegroup

Ignore o prompt de conformação durante a atualização da instância.

az iot ops upgrade --name myinstance -g myresourcegroup -y

Atualize a instância e especifique a ID do recurso do registro de esquema.

az iot ops upgrade --name myinstance -g myresourcegroup --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID

Parâmetros Exigidos

--name -n

Nome da instância de operações de 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

--no-progress

Desative a representação visual do trabalho.

Valores aceitos: false, true

--sr-resource-id

A ID do recurso de registro de esquema a ser usada com o IoT Operations. Necessário se a ID do recurso de registro de esquema não for mais encontrada nas Operações de IoT.

--yes -y

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

Valores aceitos: false, true

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops verify-host

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Executa um conjunto de verificações de host de cluster para compatibilidade de implantação de operações de IoT.

Destinado a ser executado diretamente em um host de cluster de destino. O comando pode solicitar a aplicação de um conjunto de ações privilegiadas, como instalar uma dependência. Nesse caso, a CLI deve ser executada com permissões elevadas. Por exemplo, sudo AZURE_EXTENSION_DIR=~/.azure/cliextensions az iot ops verify-host.

az iot ops verify-host [--no-progress {false, true}]

Parâmetros Opcionais

--no-progress

Desative a representação visual do trabalho.

Valores aceitos: false, true

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.