az dt model

Nota:

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

Administre modelos y definiciones de DTDL en una instancia de Digital Twins.

Comandos

Nombre	Description	Tipo	Estado
az dt model create	Carga uno o varios modelos.	Extensión	GA
az dt model delete	Eliminar un modelo. Un modelo solo se puede eliminar si ningún otro modelo hace referencia a él.	Extensión	GA
az dt model delete-all	Elimine todos los modelos de una instancia de Digital Twins.	Extensión	GA
az dt model list	Enumerar metadatos, definiciones y dependencias del modelo.	Extensión	GA
az dt model show	Recupere un modelo de destino o una definición de modelo.	Extensión	GA
az dt model update	Actualiza los metadatos de un modelo. Actualmente solo se puede descommisionar un modelo.	Extensión	GA

az dt model create

Carga uno o varios modelos.

--models puede ser json insertado o ruta de acceso de archivo. El tamaño del conjunto de modelos de entrada (ontología) está restringido por el número máximo de modelos que la instancia de DT puede almacenar (el valor predeterminado es 10000 modelos).

az dt model create --dt-name
                   [--failure-policy {None, Rollback}]
                   [--fd]
                   [--max-models-per-batch]
                   [--models]
                   [--resource-group]

Ejemplos

Cargue en bloque todos los archivos de modelo .json o .dtdl desde un directorio de destino. El procesamiento de modelos es recursivo.

az dt model create -n {instance_or_hostname} --from-directory {directory_path}

Cargue el json del modelo insertado o desde la ruta de acceso del archivo.

az dt model create -n {instance_or_hostname} --models {file_path_or_inline_json}

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia o nombre de host de Digital Twins. Si se proporciona un nombre de instancia, primero se consulta la suscripción de usuario para que la instancia de destino recupere el nombre de host. Si se proporciona un nombre de host, se omite la consulta de suscripción y el valor proporcionado se usa para la interacción posterior.

Parámetros opcionales

--failure-policy --fp

Indica la directiva de error cuando se produce un error al procesar un lote de modelos. En el modo "Reversión", todos los modelos creados en lotes anteriores se eliminan de uno en uno. Cuando se selecciona como "Ninguno", los modelos creados en lotes anteriores no se eliminan de la instancia de DT.

valores aceptados: None, Rollback

valor predeterminado: Rollback

--fd --from-directory

Los archivos de modelo JSON del directorio se analizarán desde. Nota: Los modelos se crean de forma atómica cuando el directorio contiene 250 o menos modelos, por lo que, en caso de error, no se crea ninguno de los modelos. El conjunto de modelos de entrada se fragmenta y crea en lotes cuando el directorio tiene más de 250 modelos (límite de API). En el caso de un error que procesa un lote, el comportamiento viene determinado por el parámetro --failure-policy.

--max-models-per-batch --mmpb

Habilitación de características

Tamaño máximo del modelo por lote al crear más de 250 modelos. Reduzca este número para evitar un error DTDLParser.

valor predeterminado: 30

--models

Json de modelo insertado o ruta de acceso de archivo al json del modelo. Nota: Los modelos se crean de forma atómica cuando el json del modelo contiene 250 o menos modelos, por lo que, en caso de error, ninguno de los modelos se crea. El conjunto de modelos de entrada se fragmenta y se crea en lotes cuando el json del modelo tiene más de 250 modelos (límite de API). En el caso de un error que procesa un lote, el comportamiento viene determinado por el parámetro --failure-policy.

--resource-group -g

Grupo de recursos de instancia de Digital Twins. 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 dt model delete

Eliminar un modelo. Un modelo solo se puede eliminar si ningún otro modelo hace referencia a él.

az dt model delete --dt-name
                   --dtmi
                   [--resource-group]

Ejemplos

Elimine un modelo de destino.

az dt model delete -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia o nombre de host de Digital Twins. Si se proporciona un nombre de instancia, primero se consulta la suscripción de usuario para que la instancia de destino recupere el nombre de host. Si se proporciona un nombre de host, se omite la consulta de suscripción y el valor proporcionado se usa para la interacción posterior.

--dtmi --model-id -m

Id. de modelo de Digital Twins. Ejemplo: dtmi:com:example:Room;2.

Parámetros opcionales

--resource-group -g

Grupo de recursos de instancia de Digital Twins. 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 dt model delete-all

Elimine todos los modelos de una instancia de Digital Twins.

Las configuraciones de gemelos no se ven afectadas, pero pueden interrumpirse sin definiciones de modelo.

az dt model delete-all --dt-name
                       [--resource-group]
                       [--yes]

Ejemplos

Elimine todos los modelos.

az dt model delete-all -n {instance_or_hostname}

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia o nombre de host de Digital Twins. Si se proporciona un nombre de instancia, primero se consulta la suscripción de usuario para que la instancia de destino recupere el nombre de host. Si se proporciona un nombre de host, se omite la consulta de suscripción y el valor proporcionado se usa para la interacción posterior.

Parámetros opcionales

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--yes -y

No solicita confirmación.

valor predeterminado: False

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 dt model list

Enumerar metadatos, definiciones y dependencias del modelo.

az dt model list --dt-name
                 [--def {false, true}]
                 [--dependencies-for]
                 [--resource-group]

Ejemplos

Enumerar metadatos del modelo

az dt model list -n {instance_or_hostname}

Enumerar definiciones de modelo

az dt model list -n {instance_or_hostname} --definition

Enumerar las dependencias de determinados modelos preexistentes. Espaciar valores dtmi independientes.

az dt model list -n {instance_or_hostname} --dependencies-for {model_id0} {model_id1}

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia o nombre de host de Digital Twins. Si se proporciona un nombre de instancia, primero se consulta la suscripción de usuario para que la instancia de destino recupere el nombre de host. Si se proporciona un nombre de host, se omite la consulta de suscripción y el valor proporcionado se usa para la interacción posterior.

Parámetros opcionales

--def --definition

La operación recuperará la definición del modelo.

valores aceptados: false, true

valor predeterminado: False

--dependencies-for

Conjunto de modelos que tendrán sus dependencias recuperadas. Si se omite, se recuperan todos los modelos. El formato es una lista separada por espacios en blanco.

--resource-group -g

Grupo de recursos de instancia de Digital Twins. 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 dt model show

Recupere un modelo de destino o una definición de modelo.

az dt model show --dt-name
                 --dtmi
                 [--def {false, true}]
                 [--resource-group]

Ejemplos

Mostrar metadatos del modelo

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

Mostrar metadatos y definiciones del modelo

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --definition

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia o nombre de host de Digital Twins. Si se proporciona un nombre de instancia, primero se consulta la suscripción de usuario para que la instancia de destino recupere el nombre de host. Si se proporciona un nombre de host, se omite la consulta de suscripción y el valor proporcionado se usa para la interacción posterior.

--dtmi --model-id -m

Id. de modelo de Digital Twins. Ejemplo: dtmi:com:example:Room;2.

Parámetros opcionales

--def --definition

La operación recuperará la definición del modelo.

valores aceptados: false, true

valor predeterminado: False

--resource-group -g

Grupo de recursos de instancia de Digital Twins. 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 dt model update

Actualiza los metadatos de un modelo. Actualmente solo se puede descommisionar un modelo.

az dt model update --dt-name
                   --dtmi
                   [--decommission {false, true}]
                   [--resource-group]

Ejemplos

Descommisionar un modelo de destino

az dt model update -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --decommission

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia o nombre de host de Digital Twins. Si se proporciona un nombre de instancia, primero se consulta la suscripción de usuario para que la instancia de destino recupere el nombre de host. Si se proporciona un nombre de host, se omite la consulta de suscripción y el valor proporcionado se usa para la interacción posterior.

--dtmi --model-id -m

Id. de modelo de Digital Twins. Ejemplo: dtmi:com:example:Room;2.

Parámetros opcionales

--decommission

Indica la intención de retirar un modelo de destino.

valores aceptados: false, true

--resource-group -g

Grupo de recursos de instancia de Digital Twins. 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.