Partilhar via


az iot ops

Nota

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.

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 MQTT Broker 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 IoT verificarão periodicamente se uma nova versão de extensão está disponível. Esse comportamento pode ser desabilitado com az config set iotops.check_latest=falseo .

Comandos

Name Description Tipo Status
az iot ops asset

Gestão de ativos.

Extensão GA
az iot ops asset create

Crie um elemento.

Extensão GA
az iot ops asset dataset

Gerencie conjuntos de dados em um ativo.

Extensão GA
az iot ops asset dataset list

Listar conjuntos de dados dentro de um ativo.

Extensão GA
az iot ops asset dataset point

Gerencie pontos de dados em um conjunto de dados de ativos.

Extensão GA
az iot ops asset dataset point add

Adicione um ponto de dados a um conjunto de dados de ativos.

Extensão GA
az iot ops asset dataset point export

Exporte pontos de dados em um conjunto de dados de ativos.

Extensão GA
az iot ops asset dataset point import

Importe pontos de dados em um conjunto de dados de ativos.

Extensão GA
az iot ops asset dataset point list

Listar pontos de dados em um conjunto de dados de ativos.

Extensão GA
az iot ops asset dataset point remove

Remova um ponto de dados em um conjunto de dados de ativos.

Extensão GA
az iot ops asset dataset show

Mostrar um conjunto de dados dentro de um ativo.

Extensão GA
az iot ops asset delete

Excluir um ativo.

Extensão GA
az iot ops asset endpoint

Gerencie perfis de ponto de extremidade de ativos.

Extensão GA
az iot ops asset endpoint create

Crie perfis de ponto de extremidade de ativos.

Extensão GA
az iot ops asset endpoint create opcua

Crie um perfil de ponto de extremidade de ativo com um conector OPCUA.

Extensão GA
az iot ops asset endpoint delete

Exclua um perfil de ponto de extremidade de ativo.

Extensão GA
az iot ops asset endpoint query

Consulte o Gráfico de Recursos para perfis de ponto de extremidade de ativos.

Extensão GA
az iot ops asset endpoint show

Mostrar um perfil de ponto de extremidade de ativo.

Extensão GA
az iot ops asset endpoint update

Atualize um perfil de ponto de extremidade de ativo.

Extensão GA
az iot ops asset event

Gerencie eventos em um ativo.

Extensão GA
az iot ops asset event add

Adicione um evento a um ativo.

Extensão GA
az iot ops asset event export

Exportar eventos em um ativo.

Extensão GA
az iot ops asset event import

Importar eventos em um ativo.

Extensão GA
az iot ops asset event list

Listar eventos em um ativo.

Extensão GA
az iot ops asset event remove

Remova um evento em um ativo.

Extensão GA
az iot ops asset query

Consulte o gráfico de recursos para ativos.

Extensão GA
az iot ops asset show

Mostrar um ativo.

Extensão GA
az iot ops asset update

Atualize um ativo.

Extensão GA
az iot ops broker

Gestão de corretores Mqtt.

Extensão GA
az iot ops broker authn

Gerenciamento de autenticação de broker.

Extensão GA
az iot ops broker authn delete

Exclua um recurso de autenticação do agente mqtt.

Extensão GA
az iot ops broker authn list

Liste os recursos de autenticação do agente mqtt associados a uma instância.

Extensão GA
az iot ops broker authn show

Mostrar detalhes de um recurso de autenticação do agente mqtt.

Extensão GA
az iot ops broker authz

Gestão de autorizações de corretores.

Extensão GA
az iot ops broker authz delete

Exclua um recurso de autorização do broker mqtt.

Extensão GA
az iot ops broker authz list

Liste os recursos de autorização do broker mqtt associados a uma instância.

Extensão GA
az iot ops broker authz show

Mostrar detalhes de um recurso de autorização do corretor mqtt.

Extensão GA
az iot ops broker delete

Exclua um broker mqtt.

Extensão GA
az iot ops broker list

Liste corretores mqtt associados a uma instância.

Extensão GA
az iot ops broker listener

Gestão de ouvintes de corretores.

Extensão GA
az iot ops broker listener delete

Exclua um ouvinte do broker mqtt.

Extensão GA
az iot ops broker listener list

Liste os ouvintes do corretor mqtt associados a um corretor.

Extensão GA
az iot ops broker listener show

Mostrar detalhes de um ouvinte do corretor mqtt.

Extensão GA
az iot ops broker show

Mostrar detalhes de um corretor mqtt.

Extensão GA
az iot ops check

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

Extensão Pré-visualizar
az iot ops connector

Gestão de conectores.

Extensão Pré-visualizar
az iot ops connector opcua

Gestão de conectores OPC UA.

Extensão Pré-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 Pré-visualizar
az iot ops connector opcua client add

Adicione um certificado de instância de aplicativo cliente de nível empresarial.

Extensão Pré-visualizar
az iot ops connector opcua client remove

Remova o certificado de instância do aplicativo cliente do OPC UA Broker.

Extensão Pré-visualizar
az iot ops connector opcua client show

Mostrar detalhes do recurso secretsync 'aio-opc-ua-broker-client-certificate'.

Extensão Pré-visualizar
az iot ops connector opcua issuer

Gerencie certificados de emissor para o OPC UA Broker.

Extensão Pré-visualizar
az iot ops connector opcua issuer add

Adicione um certificado de emissor à lista de certificados de emissor do OPC UA Broker.

Extensão Pré-visualizar
az iot ops connector opcua issuer remove

Remova o(s) certificado(s) confiável(is) da lista de certificados de emissor do OPC UA Broker.

Extensão Pré-visualizar
az iot ops connector opcua issuer show

Mostrar detalhes do recurso secretsync 'aio-opc-ua-broker-issuer-list'.

Extensão Pré-visualizar
az iot ops connector opcua trust

Gerencie certificados confiáveis para o OPC UA Broker.

Extensão Pré-visualizar
az iot ops connector opcua trust add

Adicione um certificado confiável à lista de certificados confiáveis do OPC UA Broker.

Extensão Pré-visualizar
az iot ops connector opcua trust remove

Remova o(s) certificado(s) confiável(is) da lista de certificados confiáveis do OPC UA Broker.

Extensão Pré-visualizar
az iot ops connector opcua trust show

Mostrar detalhes do recurso secretsync 'aio-opc-ua-broker-trust-list'.

Extensão Pré-visualizar
az iot ops create

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

Extensão GA
az iot ops dataflow

Gestão de fluxo de dados.

Extensão GA
az iot ops dataflow endpoint

Gerenciamento de ponto final de fluxo de dados.

Extensão GA
az iot ops dataflow endpoint list

Listar recursos de ponto de extremidade de fluxo de dados associados a uma instância.

Extensão GA
az iot ops dataflow endpoint show

Mostrar detalhes de um recurso de ponto de extremidade de fluxo de dados.

Extensão GA
az iot ops dataflow list

Listar fluxos de dados associados a um perfil de fluxo de dados.

Extensão GA
az iot ops dataflow profile

Gestão de perfis de fluxo de dados.

Extensão GA
az iot ops dataflow profile list

Listar perfis de fluxo de dados associados a uma instância.

Extensão GA
az iot ops dataflow profile show

Mostrar detalhes de um perfil de fluxo de dados.

Extensão GA
az iot ops dataflow show

Mostrar detalhes de um fluxo de dados associado a um perfil de fluxo de dados.

Extensão GA
az iot ops delete

Exclua as operações de IoT do cluster.

Extensão GA
az iot ops identity

Gerenciamento de identidade de instância.

Extensão GA
az iot ops identity assign

Atribua uma identidade gerenciada atribuída pelo usuário à instância.

Extensão GA
az iot ops identity remove

Remova uma identidade gerenciada atribuída pelo usuário da instância.

Extensão GA
az iot ops identity show

Mostrar as identidades da instância.

Extensão GA
az iot ops init

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

Extensão GA
az iot ops list

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

Extensão GA
az iot ops schema

Gestão de esquemas e registos.

Extensão Pré-visualizar
az iot ops schema create

Crie um esquema dentro de um registro de esquema.

Extensão Pré-visualizar
az iot ops schema delete

Exclua um esquema de destino dentro de um registro de esquema.

Extensão Pré-visualizar
az iot ops schema list

Listar esquemas dentro de um registro de esquema.

Extensão Pré-visualizar
az iot ops schema registry

Gerenciamento de registro de esquema.

Extensão Pré-visualizar
az iot ops schema registry create

Crie um registro de esquema.

Extensão Pré-visualizar
az iot ops schema registry delete

Exclua um registro de esquema de destino.

Extensão Pré-visualizar
az iot ops schema registry list

Listar registros de esquema em um grupo de recursos ou assinatura.

Extensão Pré-visualizar
az iot ops schema registry show

Mostrar detalhes de um registro de esquema.

Extensão Pré-visualizar
az iot ops schema show

Mostrar detalhes de um esquema dentro de um registro de esquema.

Extensão Pré-visualizar
az iot ops schema show-dataflow-refs

Mostrar as referências de esquema usadas para fluxos de dados.

Extensão Experimentais
az iot ops schema version

Gerenciamento de versão do esquema.

Extensão Pré-visualizar
az iot ops schema version add

Adicione uma versão do esquema a um esquema.

Extensão Pré-visualizar
az iot ops schema version list

Listar versões de esquema para um esquema específico.

Extensão Pré-visualizar
az iot ops schema version remove

Remova uma versão do esquema de destino.

Extensão Pré-visualizar
az iot ops schema version show

Mostrar detalhes de uma versão do esquema.

Extensão Pré-visualizar
az iot ops secretsync

Gerenciamento de sincronização secreta de instância.

Extensão Pré-visualizar
az iot ops secretsync disable

Desative a sincronização secreta para uma instância.

Extensão Pré-visualizar
az iot ops secretsync enable

Habilite a sincronização secreta para uma instância.

Extensão Pré-visualizar
az iot ops secretsync list

Liste as configurações de sincronização secretas associadas a uma instância.

Extensão Pré-visualizar
az iot ops show

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

Extensão GA
az iot ops support

Operações de suporte a operações IoT.

Extensão Pré-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 Pré-visualizar
az iot ops update

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

Extensão GA
az iot ops upgrade

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

Extensão Preterido

az iot ops check

Pré-visualizar

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

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

O comando, por padrão, mostra uma exibição resumida amigável 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 a verbosidade por meio do --detail-level argumento. Nota: 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/[v1]
  • mqttbroker.iotoperations.azure.com/[v1]
  • opcuabroker.iotoperations.azure.com/[v1beta1]
  • connectivity.iotoperations.azure.com/[v1]

Para obter mais informações sobre os requisitos do cluster, verifique 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 '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 do 'ativo'.

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

Use o nome do recurso para restringir os resultados aos recursos do 'ativo' com o prefixo do nome 'meu-ativo-'

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

Parâmetros Opcionais

--as-object

Conteúdo de verificação de saída e validações em uma estrutura de dados amigável para CI.

Valores aceites: false, true
--context

Nome de contexto Kubeconfig 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 vista de resumo (saída mínima), 1 para uma vista detalhada (informações mais abrangentes) ou 2 para uma vista detalhada (todas as informações disponíveis).

Valores aceites: 0, 1, 2
Default value: 0
--ops-service --svc

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

Valores aceites: akri, broker, dataflow, deviceregistry, opcua
--post

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

Valores aceites: false, true
--pre

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

Valores aceites: false, true
--resource-name --rn

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

--resources

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

Valores aceites: asset, assetendpointprofile, assettype, broker, brokerlistener, dataflow, dataflowendpoint, dataflowprofile
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az iot ops create

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

É necessária uma execução bem-sucedida do init antes de executar este comando.

O resultado do comando conecta uma instância de Operações 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-train]
                  [--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 broker padrão, bem como uma descrição de instância e tags.

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 broker 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 cert-manager fornecida pelo usuário. Observe que o cluster deve ter sido inicializado com '--user-trust' e uma implantação de usuário cert-manager 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 Obrigatórios

--cluster

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

--name -n

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

--resource-group -g

o 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 operações IoT.

Parâmetros Opcionais

--add-insecure-listener

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

Valores aceites: false, true
--bp --broker-backend-part

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

Default value: 2
--br --broker-backend-rf

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

Default value: 2
--broker-backend-workers --bw

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

Default value: 2
--broker-config-file

Caminho para um arquivo json com propriedades de configuração do broker personalizadas. O conteúdo de configuração de arquivo é usado sobre parâmetros de configuração de broker 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 frontend do broker Mqtt. Valor mínimo: 1, valor máximo: 16.

Default value: 2
--broker-frontend-workers --fw

Trabalhadores frontend corretores Mqtt. Valor mínimo: 1, valor máximo: 16.

Default value: 2
--broker-listener-type --lt

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

Valores aceites: ClusterIp, LoadBalancer, NodePort
Default value: ClusterIp
--broker-mem-profile --mp

Perfil de memória do broker Mqtt.

Valores aceites: High, Low, Medium, Tiny
Default value: Medium
--cluster-namespace

O namespace de cluster IoT Operations infra será implantado. Deve ser minúscula.

Default value: azure-iot-operations
--custom-location

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

--description

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

--df-profile-instances

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

Default value: 1
--enable-rsync

As regras de sincronização de recursos serão incluídas na implantação das Operações IoT.

Valores aceites: false, true
--kubernetes-distro

A distro 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 aceites: K3s, K8s, MicroK8s
Default value: 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 aceites: false, true
--ops-config

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

--ops-train
Preterido

O argumento 'ops_train' foi preterido e será removido em uma versão futura.

Use para substituir o trem de liberação de extensão de arco IoT Operations integrado.

--ops-version
Preterido

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

Use para substituir a versão interna da extensão de arco IoT Operations.

--runtime-socket

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

--tags

Tags de instância. Saco de propriedades em pares chave-valor 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 TLS componente. O formato é separado por espaço dos pares chave=valor. As seguintes chaves são necessárias: issuerName, configMapKey, issuerKind, configMapName. Se não for usado, um pacote de confiança autoassinado fornecido pelo sistema será configurado.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az iot ops delete

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 recursos correlacionados. O Gráfico de Recursos ser 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 o processo de exclusão. Útil para cenários de IC.

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

Forçar a 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 Obrigatórios

--resource-group -g

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

--force

Forçar a execução da operação.

Valores aceites: false, true
--include-deps

Indica que o comando deve remover as dependências das Operações IoT. Esta opção destina-se a inverter a aplicação do init.

Valores aceites: false, true
--name -n

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

--no-progress

Desative a representação visual do trabalho.

Valores aceites: false, true
--yes -y

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

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

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az iot ops init

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

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

A operação init funcionará na instalação e configuração de uma camada básica 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 básica de Operações IoT.

az iot ops init --cluster mycluster -g myresourcegroup

Semelhante ao exemplo anterior, mas com a tolerância a falhas do Arc Container Storage ativada (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 Obrigatórios

--cluster

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

--resource-group -g

o 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 Azure Arc Container Storage. São necessários pelo menos 3 nós de cluster.

Valores aceites: false, true
--ensure-latest

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

Valores aceites: false, true
--no-progress

Desative a representação visual do trabalho.

Valores aceites: 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 aceites: false, true
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az iot ops list

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

Liste 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

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az iot ops show

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

Opcionalmente, o comando pode gerar uma estrutura em árvore de recursos associados que representam a implantação de Operações IoT em relação ao cluster de suporte.

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 em árvore de recursos associados que representam a implantação de Operações IoT.

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

Parâmetros Obrigatórios

--name -n

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

--resource-group -g

o 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 das Operações IoT no cluster de suporte.

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

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az iot ops update

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

Atualmente, as tags e a descrição da instância podem ser atualizadas.

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

Exemplos

Atualize as tags de instância. Isto equivale 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 Obrigatórios

--name -n

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

--resource-group -g

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

--tags

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az iot ops upgrade

Preterido

Este comando foi preterido e será removido em uma versão futura.

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

AVISO: Este comando pode falhar e exigir que você exclua e recrie seu cluster e instância.

Atualize uma instância de Operações IoT, incluindo a atualização das extensões para as versões mais recentes. Use este comando se az iot ops show comandos ou 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 entradas mínimas.

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 de registro do esquema.

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

Parâmetros Obrigatórios

--name -n

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

--resource-group -g

o 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 aceites: false, true
--sr-resource-id

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

--yes -y

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

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

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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