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=false
o .
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
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
Conteúdo de verificação de saída e validações em uma estrutura de dados amigável para CI.
Nome de contexto Kubeconfig a ser usado para comunicação de cluster k8s. Se nenhum contexto for fornecido, current_context será usado.
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).
A implantação do serviço IoT Operations que será avaliada.
Execute verificações pós-implantação.
Execute verificações de pré-requisitos para determinar se os requisitos mínimos de uma implantação de serviço são atendidos.
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 «».
Execute verificações apenas em tipos de recursos específicos. Use valores separados por espaço.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
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
Nome do cluster de destino para implantação de Operações IoT.
Nome da instância de Operações IoT.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
A ID do recurso de registro de esquema a ser usada com operações IoT.
Parâmetros Opcionais
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.
Partições de back-end do broker Mqtt. Valor mínimo: 1, valor máximo: 16.
Fator de redundância de back-end do corretor Mqtt. Valor mínimo: 1, valor máximo: 5.
Trabalhadores de backend do corretor Mqtt. Valor mínimo: 1, valor máximo: 16.
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.
Réplicas de frontend do broker Mqtt. Valor mínimo: 1, valor máximo: 16.
Trabalhadores frontend corretores Mqtt. Valor mínimo: 1, valor máximo: 16.
Tipo de serviço associado ao ouvinte padrão do broker mqtt.
Perfil de memória do broker Mqtt.
O namespace de cluster IoT Operations infra será implantado. Deve ser minúscula.
O nome do local personalizado correspondente à implantação das Operações IoT. O padrão está no formato 'location-{hash(5)}'.
Descrição da instância de Operações IoT.
A contagem de instâncias associada ao perfil de fluxo de dados padrão.
As regras de sincronização de recursos serão incluídas na implantação das Operações IoT.
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.
A região que será usada para garantia de recursos provisionados. Se não for fornecido, o local do cluster conectado será usado.
Desative a representação visual do trabalho.
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.
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.
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.
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 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.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
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
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Opcionais
Nome do cluster de destino para exclusão de Operações IoT.
Forçar a execução da operação.
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.
Nome da instância de Operações IoT.
Desative a representação visual do trabalho.
Confirme [s]es sem um prompt. Útil para cenários de CI e automação.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
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
Nome do cluster de destino para implantação de Operações IoT.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Opcionais
Habilite a tolerância a falhas para o Azure Arc Container Storage. São necessários pelo menos 3 nós de cluster.
Verifique se a CLI de IoT Ops mais recente está sendo usada, gerando um erro se uma atualização estiver disponível.
Desative a representação visual do trabalho.
Ignore a implantação do sistema cert-manager e trust-manager em favor de uma configuração fornecida pelo usuário.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
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
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
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
Nome da instância de Operações IoT.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Opcionais
Use para visualizar a implantação das Operações IoT no cluster de suporte.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
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
Nome da instância de Operações IoT.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Opcionais
Descrição da instância de Operações IoT.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az iot ops upgrade
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
Nome da instância de Operações IoT.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Opcionais
Desative a representação visual do trabalho.
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.
Confirme [s]es sem um prompt. Útil para cenários de CI e automação.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.