Partilhar via

az iot ops schema registry

  • Pré-visualizar

Observação

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

O grupo de comandos 'iot ops schema' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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

Name Description Tipo Status
az iot ops schema registry create

Crie um registro de esquema.

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

Exclua um registro de esquema de destino.

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

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

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

Mostrar detalhes de um registro de esquema.

 Extensão Pré-visualização

az iot ops schema registry create

Pré-visualizar

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

Crie um registro de esquema.

Esta 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" em relação ao escopo do contêiner da conta de armazenamento por padrão. Se necessário, você pode fornecer uma função personalizada via --custom-role-id para usar.

Se o contêiner de 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 --rn
                                  --resource-group
                                  --sa-resource-id
                                  [--custom-role-id]
                                  [--desc]
                                  [--display-name]
                                  [--location]
                                  [--sa-container]
                                  [--skip-ra {false, true}]
                                  [--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 Obrigatórios

--name -n

Nome do registro do esquema.

--registry-namespace --rn

Namespace do Registro de esquema. Identifica exclusivamente um registro de esquema dentro de 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 usado com o registro do 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 para o registro de esquema.

--display-name

Nome de exibição para o registro do 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 onde os esquemas serão armazenados.

Default value: schemas
--skip-ra

Quando usada, a etapa de atribuição de função da operação será ignorada.

Valores aceites: false, true
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

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

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

--verbose

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

az iot ops schema registry delete

Pré-visualizar

O grupo de comandos 'iot ops schema' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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 Obrigatórios

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

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

--verbose

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

az iot ops schema registry list

Pré-visualizar

O grupo de comandos 'iot ops schema' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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

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

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

--verbose

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

az iot ops schema registry show

Pré-visualizar

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

Mostrar detalhes de um registro de esquema.

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

Exemplos

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

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

Parâmetros Obrigatórios

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

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

--verbose

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