Compartir a través de


az iot ops schema

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 . Obtenga más información sobre las extensiones.

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

Administración de esquemas y registros.

Los esquemas son documentos que describen los datos para habilitar el procesamiento y la contextualización. Los esquemas de mensaje describen el formato de un mensaje y su contenido. Se requiere un registro de esquema para crear y administrar esquemas.

Comandos

Nombre Description Tipo Estado
az iot ops schema create

Cree un esquema dentro de un registro de esquema.

Extensión Vista previa
az iot ops schema delete

Elimine un esquema de destino dentro de un registro de esquema.

Extensión Vista previa
az iot ops schema list

Enumerar esquemas dentro de un registro de esquema.

Extensión Vista previa
az iot ops schema registry

Administración del registro de esquemas.

Extensión Vista previa
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 show

Mostrar detalles de un esquema dentro de un registro de esquema.

Extensión Vista previa
az iot ops schema show-dataflow-refs

Mostrar las referencias de esquema usadas para los flujos de datos.

Extensión Experimental
az iot ops schema version

Administración de versiones de esquema.

Extensión Vista previa
az iot ops schema version add

Agregue una versión de esquema a un esquema.

Extensión Vista previa
az iot ops schema version list

Enumerar las versiones de esquema para un esquema específico.

Extensión Vista previa
az iot ops schema version remove

Quite una versión de esquema de destino.

Extensión Vista previa
az iot ops schema version show

Mostrar detalles de una versión de esquema.

Extensión Vista previa

az iot ops schema 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 esquema dentro de un registro de esquema.

Esta operación requiere un registro de esquema creado previamente y agregará una versión de esquema. Para crear el esquema y agregar una versión, la cuenta de almacenamiento asociada deberá tener habilitado el acceso a la red pública. Para obtener más información sobre el formato de archivo delta, consulte aka.ms/lakehouse-delta-sample.

az iot ops schema create --format {delta, json}
                         --name
                         --registry
                         --resource-group
                         --type {message}
                         --vc
                         [--desc]
                         [--display-name]
                         [--vd]
                         [--ver]

Ejemplos

Cree un esquema denominado "myschema" en el registro "myregistry" con entradas mínimas. La versión 1 del esquema se creará para este esquema con el contenido del archivo.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format json --type message --version-content myschema.json

Cree un esquema denominado "myschema" con personalización adicional. La versión 14 del esquema se creará para este esquema. El contenido insertado es un ejemplo de sintaxis de PowerShell.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format delta --type message --desc "Schema for Assets" --display-name myassetschema --version-content '{\"hello\": \"world\"}' --ver 14 --vd "14th version"

Cree un esquema denominado "myschema". La versión 1 del esquema se creará para este esquema. El contenido insertado es un ejemplo de sintaxis cmd.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format json --type message --version-content "{\"hello\": \"world\"}"

Cree un esquema denominado "myschema". La versión 1 del esquema se creará para este esquema. El contenido insertado es un ejemplo de sintaxis de Bash.

az iot ops schema create -n myschema -g myresourcegroup --registry myregistry --format json --type message --version-content '{"hello": "world"}'

Parámetros requeridos

--format

Formato de esquema.

Valores aceptados: delta, json
--name -n

Nombre del esquema.

--registry

Nombre del registro de esquema.

--resource-group -g

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

--type

Tipo de esquema.

Valores aceptados: message
--vc --version-content

Ruta de acceso de archivo que contiene o contenido insertado para la versión.

Parámetros opcionales

--desc

Descripción del esquema.

--display-name

Nombre para mostrar del esquema.

--vd --version-desc

Descripción de la versión.

--ver --version

Nombre de la versión del esquema.

Valor predeterminado: 1
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 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 esquema de destino dentro de un registro de esquema.

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

Ejemplos

Elimine un esquema de destino "myschema" dentro de un registro de esquema "myregistry".

az iot ops schema delete --name myschema --registry myregistry -g myresourcegroup

Parámetros requeridos

--name -n

Nombre del esquema.

--registry

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 opcionales

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

Enumerar esquemas dentro de un registro de esquema.

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

Ejemplos

Enumere los registros de esquema en el registro de esquema "myregistry".

az iot ops schema list -g myresourcegroup --registry myregistry

Parámetros requeridos

--registry

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.

az iot ops schema 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 esquema dentro de un registro de esquema.

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

Ejemplos

Mostrar detalles del esquema de destino "myschema" dentro de un registro de esquema "myregistry".

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

Parámetros requeridos

--name -n

Nombre del esquema.

--registry

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.

az iot ops schema show-dataflow-refs

Habilitación de características

Este comando es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Mostrar las referencias de esquema usadas para los flujos de datos.

az iot ops schema show-dataflow-refs --registry
                                     --resource-group
                                     [--latest {false, true}]
                                     [--schema]
                                     [--ver]

Ejemplos

Mostrar referencia de esquema para el esquema "myschema" y la versión 1.

az iot ops schema show-dataflow-refs --version 1 --schema myschema --registry myregistry -g myresourcegroup

Mostrar referencia de esquema para todas las versiones del esquema "myschema".

az iot ops schema show-dataflow-refs --schema myschema --registry myregistry -g myresourcegroup

Mostrar referencia de esquema para todas las versiones y esquemas del registro de esquema "myregistry".

az iot ops schema show-dataflow-refs --registry myregistry -g myresourcegroup

Mostrar referencia de esquema para todos los esquemas, pero solo las versiones más recientes del registro de esquema "myregistry".

az iot ops schema show-dataflow-refs --registry myregistry -g myresourcegroup --latest

Parámetros requeridos

--registry

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 opcionales

--latest

Marca para mostrar solo las versiones más recientes.

Valores aceptados: false, true
--schema

Nombre del esquema. Obligatorio si se usa --version.

--ver --version

Nombre de la versión del esquema. Si se usa, se omitirá --latest.

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.