Compartir a través de

az iot ops schema registry

  • Vista previa
  • Referencia

Nota:

Esta referencia forma parte de la extensión azure-iot-ops para la CLI de Azure (versión 2.53.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az iot ops schema registry . Obtenga más información sobre las extensiones.

El grupo de comandos "esquema de iot ops" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administración del registro de esquemas.

Un registro de esquema es un repositorio centralizado para administrar esquemas. El registro de esquemas permite la generación y recuperación de esquemas tanto en el perímetro como en la nube. Garantiza la coherencia y la compatibilidad entre sistemas proporcionando una única fuente de verdad para las definiciones de esquema.

Comandos

Nombre Description Tipo Estado
az iot ops schema registry create

Cree un registro de esquema.

 Extensión Vista previa
az iot ops schema registry delete

Elimine un registro de esquema de destino.

 Extensión Vista previa
az iot ops schema registry list

Enumera los registros de esquema en un grupo de recursos o una suscripción.

 Extensión Vista previa
az iot ops schema registry show

Mostrar detalles de un registro de esquema.

 Extensión Vista previa

az iot ops schema registry create

Vista previa

El grupo de comandos "esquema de iot ops" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree un registro de esquema.

Esta operación creará un registro de esquema con la identidad administrada del sistema habilitada.

A continuación, asignará a la identidad del sistema el rol integrado "Colaborador de datos de Storage Blob" en el ámbito del contenedor de la cuenta de almacenamiento de forma predeterminada. Si es necesario, puede proporcionar un rol personalizado a través de --custom-role-id para usarlo en su lugar.

Si el contenedor de cuentas de almacenamiento indicado no existe, se creará con la configuración predeterminada.

Esta operación también registrará el proveedor de recursos Microsoft.DeviceRegistry si no está 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]

Ejemplos

Cree un registro de esquema denominado "myregistry" con entradas mínimas.

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

Cree un registro de esquema denominado "myregistry" en la región westus2 con personalización 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 requeridos

--name -n

Nombre del registro de esquema.

--registry-namespace --rn

Espacio de nombres del Registro de esquema. Identifica de forma única un registro de esquema dentro de un inquilino.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--sa-resource-id

Identificador de recurso de la cuenta de almacenamiento que se va a usar con el registro de esquema.

Parámetros opcionales

--custom-role-id

Identificador de definición de roles completo en el siguiente formato: /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleId}.

--desc

Descripción del registro de esquema.

--display-name

Nombre para mostrar del registro de esquema.

--location -l

Región para crear el registro de esquema. Si no se proporciona ninguna ubicación, se usará la ubicación del grupo de recursos.

--sa-container

Nombre del contenedor de la cuenta de almacenamiento donde se almacenarán los esquemas.

Valor predeterminado: schemas
--tags

Etiquetas del Registro de esquema. Contenedor de propiedades en pares clave-valor con el formato siguiente: a=b c=d. Use --tags "" para quitar todas las etiquetas.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot ops schema registry delete

Vista previa

El grupo de comandos "esquema de iot ops" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine un registro de esquema de destino.

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

Ejemplos

Elimine el registro de esquema "myregistry".

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

Parámetros requeridos

--name -n

Nombre del registro de esquema.

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--yes -y

Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.

Valores aceptados: false, true
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot ops schema registry list

Vista previa

El grupo de comandos "esquema de iot ops" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumera los registros de esquema en un grupo de recursos o una suscripción.

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

Ejemplos

Enumera los registros de esquemas en el grupo de recursos "myresourcegroup".

az iot ops schema registry list -g myresourcegroup

Enumera los registros de esquemas en el filtrado de suscripciones predeterminado en una etiqueta determinada.

az iot ops schema registry list --query "[?tags.env == 'prod']"

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot ops schema registry show

Vista previa

El grupo de comandos "esquema de iot ops" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Mostrar detalles de un registro de esquema.

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

Ejemplos

Mostrar detalles del registro de esquema de destino "myregistry".

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

Parámetros requeridos

--name -n

Nombre del registro de esquema.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.