Compartilhar via

az iot ops schema registry

  • Versão Prévia
  • Referência

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 schema registry . Saiba mais sobre extensões.

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

Gerenciamento de registro de esquema.

Um registro de esquema é um repositório centralizado para gerenciar esquemas. O registro de esquema permite a geração e recuperação de esquemas na borda e na nuvem. Ele garante consistência e compatibilidade entre sistemas, fornecendo uma única fonte de verdade para definições de esquema.

Comandos

Nome Description Tipo Status
az iot ops schema registry create

Crie 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 registry create

Versão Prévia

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

Crie um registro de esquema.

Essa operação criará um registro de esquema com a identidade gerenciada pelo sistema habilitada.

Em seguida, ele atribuirá à identidade do sistema a função interna "Colaborador de Dados de Blob de Armazenamento" no escopo do contêiner da conta de armazenamento por padrão. Se necessário, você pode fornecer uma função personalizada por meio de --custom-role-id para usar.

Se o contêiner da conta de armazenamento indicado não existir, ele será criado com as configurações padrão.

Essa operação também registrará o provedor de recursos Microsoft.DeviceRegistry se ele não estiver registrado.

az iot ops schema registry create --name
                                  --registry-namespace
                                  --resource-group
                                  --sa-resource-id
                                  [--custom-role-id]
                                  [--desc]
                                  [--display-name]
                                  [--location]
                                  [--sa-container]
                                  [--tags]

Exemplos

Crie um registro de esquema chamado 'myregistry' com entradas mínimas.

az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID

Crie um registro de esquema chamado 'myregistry' na região westus2 com personalização adicional.

az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID --sa-container myschemacontainer -l westus2 --desc 'Contoso factory X1 schemas' --display-name 'Contoso X1' --tags env=prod

Parâmetros Exigidos

--name -n

Nome do registro do esquema.

--registry-namespace --rn

Namespace do Registro de esquema. Identifica exclusivamente um registro de esquema em um locatário.

--resource-group -g

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

--sa-resource-id

ID do recurso da conta de armazenamento a ser usada com o registro de esquema.

Parâmetros Opcionais

--custom-role-id

ID de definição de função totalmente qualificada no seguinte formato: /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleId}.

--desc

Descrição do registro de esquema.

--display-name

Nome de exibição do registro de esquema.

--location -l

Região para criar o registro de esquema. Se nenhum local for fornecido, o local do grupo de recursos será usado.

--sa-container

Nome do contêiner da conta de armazenamento em que os esquemas serão armazenados.

Valor padrão: schemas
--tags

Marcas de registro de esquema. 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 schema registry delete

Versão Prévia

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

Exclua um registro de esquema de destino.

az iot ops schema registry delete --name
                                  [--resource-group]
                                  [--yes {false, true}]

Exemplos

Exclua o registro de esquema 'myregistry'.

az iot ops schema registry delete -n myregistry -g myresourcegroup

Parâmetros Exigidos

--name -n

Nome do registro do esquema.

Parâmetros Opcionais

--resource-group -g

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

--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 schema registry list

Versão Prévia

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

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

az iot ops schema registry list [--resource-group]

Exemplos

Listar registros de esquema no grupo de recursos 'myresourcegroup'.

az iot ops schema registry list -g myresourcegroup

Liste os registros de esquema na filtragem de assinatura padrão em uma tag específica.

az iot ops schema registry list --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 schema registry show

Versão Prévia

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

Mostrar detalhes de um registro de esquema.

az iot ops schema registry show --name
                                --resource-group

Exemplos

Mostre detalhes do registro de esquema de destino 'myregistry'.

az iot ops schema registry show --name myregistry -g myresourcegroup

Parâmetros Exigidos

--name -n

Nome do registro do esquema.

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