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.

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	GA
az iot ops asset create	Crie um ativo.	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 em 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	Exclua um ativo.	Extensão	GA
az iot ops asset endpoint	Gerencie perfis de endpoint de ativos.	Extensão	GA
az iot ops asset endpoint create	Crie perfis de endpoint de ativos.	Extensão	GA
az iot ops asset endpoint create custom	Crie um perfil de ponto de extremidade de ativo para um conector personalizado.	Extensão	Deprecado
az iot ops asset endpoint create onvif	Crie um perfil de ponto de extremidade de ativo para um conector do Onvif.	Extensão	Deprecado
az iot ops asset endpoint create opcua	Crie um perfil de ponto de extremidade de ativo para um conector OPCUA.	Extensão	GA
az iot ops asset endpoint delete	Exclua um perfil de endpoint de ativo.	Extensão	GA
az iot ops asset endpoint query	Consulte o Resource Graph para obter perfis de endpoint de ativos.	Extensão	GA
az iot ops asset endpoint show	Mostrar um perfil de endpoint de ativo.	Extensão	GA
az iot ops asset endpoint update	Atualize um perfil de endpoint 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	Importe 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 Resource Graph 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	Gerenciamento de corretor Mqtt.	Extensão	GA
az iot ops broker authn	Gerenciamento de autenticação do agente.	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	Listar 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	Gerenciamento de autorização de corretores.	Extensão	GA
az iot ops broker authz delete	Exclua um recurso de autorização do agente mqtt.	Extensão	GA
az iot ops broker authz list	Listar 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 agente mqtt.	Extensão	GA
az iot ops broker delete	Exclua um agente mqtt.	Extensão	GA
az iot ops broker list	Listar agentes mqtt associados a uma instância.	Extensão	GA
az iot ops broker listener	Gerenciamento de ouvintes de agentes.	Extensão	GA
az iot ops broker listener delete	Exclua um ouvinte do agente mqtt.	Extensão	GA
az iot ops broker listener list	Listar listeners do agente mqtt associados a um agente.	Extensão	GA
az iot ops broker listener show	Mostrar detalhes de um ouvinte do agente mqtt.	Extensão	GA
az iot ops broker show	Mostrar detalhes de um broker mqtt.	Extensão	GA
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 conector.	Extensão	Visualizar
az iot ops connector opcua	Gerenciamento do conector OPC UA.	Extensão	Visualizar
az iot ops connector opcua client	Gerenciar o certificado da instância de aplicativo cliente de nível empresarial para o Agente de UA do OPC.	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 client remove	Remova o certificado da instância do aplicativo cliente do OPC UA Broker.	Extensão	Visualizar
az iot ops connector opcua client show	Mostrar detalhes do recurso secretsync 'aio-opc-ua-broker-client-certificate'.	Extensão	Visualizar
az iot ops connector opcua issuer	Gerenciar certificados do emissor para o OPC UA Broker.	Extensão	Visualizar
az iot ops connector opcua issuer add	Adicione um certificado do emissor à lista de certificados do emissor do Agente de UA do OPC.	Extensão	Visualizar
az iot ops connector opcua issuer remove	Remova certificados confiáveis da lista de certificados do emissor do Agente de UA do OPC.	Extensão	Visualizar
az iot ops connector opcua issuer show	Mostrar detalhes do recurso secretsync 'aio-opc-ua-broker-issuer-list'.	Extensão	Visualizar
az iot ops connector opcua trust	Gerenciar 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 connector opcua trust remove	Remova certificados confiáveis da lista de certificados confiáveis do OPC UA Broker.	Extensão	Visualizar
az iot ops connector opcua trust show	Mostrar detalhes do recurso secretsync 'aio-opc-ua-broker-trust-list'.	Extensão	Visualizar
az iot ops create	Crie uma instância de Operações de IoT.	Extensão	GA
az iot ops dataflow	Gerenciamento de fluxo de dados.	Extensão	GA
az iot ops dataflow endpoint	Gerenciamento de endpoint de fluxo de dados.	Extensão	GA
az iot ops dataflow endpoint list	Listar os 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	Gerenciamento de perfil 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	Mostre as identidades da instância.	Extensão	GA
az iot ops init	Inicialize o cluster habilitado para Arc para implantação de operações de IoT.	Extensão	GA
az iot ops list	Listar instâncias de operações de IoT.	Extensão	GA
az iot ops schema	Gerenciamento de esquema e registro.	Extensão	Visualizar
az iot ops schema create	Crie um esquema em 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	Mostrar as referências de esquema usadas para fluxos de dados.	Extensão	Experimental
az iot ops schema version	Gerenciamento de versão do 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 de segredo associadas a uma instância.	Extensão	Visualizar
az iot ops show	Mostrar uma instância de operações de IoT.	Extensão	GA
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	GA
az iot ops upgrade	Atualize uma instância de Operações IoT.	Extensão	GA

az iot ops check

Versão Prévia

Esse comando 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/[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, 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, brokerauthentication, brokerauthorization, 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, brokerauthentication, brokerauthorization, 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

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-train]
                  [--ops-version]
                  [--runtime-socket]
                  [--tags]
                  [--trust-settings]
                  [--yes {false, true}]

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 do gerenciador de certificados fornecida pelo usuário. Observe que o cluster deve ter sido inicializado com '--user-trust' e uma implantação do gerenciador de certificados do 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.

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

Preterido

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

Use para substituir o trem de versão de extensão de arco do IoT Operations arc interno.

--ops-version

Preterido

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

Use para substituir a versão de extensão interna do Arco de Operações 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: issuerName, issuerKind, configMapName, configMapKey. Se não for usado, um pacote de confiança autoassinado fornecido pelo sistema será configurado.

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

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 de configurações de confiança do usuário para uma configuração personalizada do gerenciador de certificados. Isso ignorará a implantação do gerenciador de certificados do sistema e do gerenciador de confiança.

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 gerenciador de certificados do sistema e do gerenciador de confiança 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

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

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.

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

Atualize uma instância de operações de 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. 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

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

Por padrão, sem opções, o comando avaliará as versões dos serviços do lado do cluster implantados que compõem as Operações de IoT e as comparará com a implantação interna que seria executada com az iot ops init e az iot ops create.

az iot ops upgrade --name
                   --resource-group
                   [--acs-config]
                   [--acs-config-sync {add, full, none}]
                   [--acs-train]
                   [--acs-version]
                   [--no-progress {false, true}]
                   [--ops-config]
                   [--ops-config-sync {add, full, none}]
                   [--ops-train]
                   [--ops-version]
                   [--osm-config]
                   [--osm-config-sync {add, full, none}]
                   [--osm-train]
                   [--osm-version]
                   [--plat-config]
                   [--plat-config-sync {add, full, none}]
                   [--plat-train]
                   [--plat-version]
                   [--ssc-config]
                   [--ssc-config-sync {add, full, none}]
                   [--ssc-train]
                   [--ssc-version]
                   [--yes {false, true}]

Exemplos

Atualize a instância com entradas mínimas.

az iot ops upgrade --name myinstance -g myresourcegroup

Ignore o prompt de confirmação para atualização de instância. Útil para cenários de CI.

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

Defina as configurações de configuração de extensão que se aplicam devem ser durante a atualização. Para remover uma configuração, forneça a chave sem valor.

az iot ops upgrade --name myinstance -g myresourcegroup --ops-config key1=value1 deletekey

Forneça uma versão explícita do IoT Operations ou um treinamento de versão para o qual atualizar. Não recomendado para casos de uso típicos.

az iot ops upgrade --name myinstance -g myresourcegroup --ops-version x.y.z --ops-train preview

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

--acs-config

Configuração personalizada da extensão de arco ContainerStorage. O formato é pares key=value separados por espaço ou apenas a chave. Essa opção pode ser usada uma ou mais vezes.

--acs-config-sync

Preterido

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

Modo de sincronização de extensão de arco ContainerStorage. Essa opção será aplicável se uma atualização for solicitada a uma versão conhecida. O modo 'full' alterará a configuração atual para o destino, 'add' aplicará somente alterações aditivas, 'none' é um no-op.

Valores aceitos: add, full, none

Valor padrão: full

--acs-train

Use para substituir o trem de versão de extensão de arco containerStorage interno.

--acs-version

Use para substituir a versão de extensão interna containerStorage arc.

--no-progress

Desative a representação visual do trabalho.

Valores aceitos: false, true

--ops-config

Configuração personalizada da extensão do arco IotOperations. O formato é pares key=value separados por espaço ou apenas a chave. Essa opção pode ser usada uma ou mais vezes.

--ops-config-sync

Preterido

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

Modo de sincronização da extensão do arco IotOperations. Essa opção será aplicável se uma atualização for solicitada a uma versão conhecida. O modo 'full' alterará a configuração atual para o destino, 'add' aplicará somente alterações aditivas, 'none' é um no-op.

Valores aceitos: add, full, none

Valor padrão: full

--ops-train

Use para substituir o trem de versão de extensão do arco iotOperations interno.

--ops-version

Use para substituir a versão de extensão interna do arco iotOperations.

--osm-config

Configuração personalizada da extensão openServiceMesh arc. O formato é pares key=value separados por espaço ou apenas a chave. Essa opção pode ser usada uma ou mais vezes.

--osm-config-sync

Preterido

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

Modo de sincronização de extensão de arco OpenServiceMesh. Essa opção será aplicável se uma atualização for solicitada a uma versão conhecida. O modo 'full' alterará a configuração atual para o destino, 'add' aplicará somente alterações aditivas, 'none' é um no-op.

Valores aceitos: add, full, none

Valor padrão: full

--osm-train

Use para substituir o trem de versão de extensão openServiceMesh arc interno.

--osm-version

Use para substituir a versão de extensão interna openServiceMesh arc.

--plat-config

Configuração personalizada da extensão do arco da plataforma. O formato é pares key=value separados por espaço ou apenas a chave. Essa opção pode ser usada uma ou mais vezes.

--plat-config-sync

Preterido

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

Modo de sincronização de extensão do arco da plataforma. Essa opção será aplicável se uma atualização for solicitada a uma versão conhecida. O modo 'full' alterará a configuração atual para o destino, 'add' aplicará somente alterações aditivas, 'none' é um no-op.

Valores aceitos: add, full, none

Valor padrão: full

--plat-train

Use para substituir o trem de versão de extensão de arco de plataforma interno.

--plat-version

Use para substituir a versão de extensão interna do arco da plataforma.

--ssc-config

Configuração personalizada da extensão de arco SecretStore. O formato é pares key=value separados por espaço ou apenas a chave. Essa opção pode ser usada uma ou mais vezes.

--ssc-config-sync

Preterido

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

Modo de sincronização de extensão de arco SecretStore. Essa opção será aplicável se uma atualização for solicitada a uma versão conhecida. O modo 'full' alterará a configuração atual para o destino, 'add' aplicará somente alterações aditivas, 'none' é um no-op.

Valores aceitos: add, full, none

Valor padrão: full

--ssc-train

Use para substituir o trem de versão de extensão secretStore arc interno.

--ssc-version

Use para substituir a versão de extensão interna do secretStore arc.

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