Sdílet prostřednictvím

az dt model

  • Reference

Poznámka:

Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.46.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az dt model . Přečtěte si další informace o rozšířeních.

Správa modelů a definic DTDL v instanci služby Digital Twins

Příkazy

Name Description Typ Stav
az dt model create

Nahraje jeden nebo více modelů.

 Rozšíření GA
az dt model delete

Odstraňte model. Model lze odstranit pouze v případě, že na něj odkazují žádné jiné modely.

 Rozšíření GA
az dt model delete-all

Odstraňte všechny modely v instanci služby Digital Twins.

 Rozšíření GA
az dt model list

Výpis metadat modelu, definic a závislostí

 Rozšíření GA
az dt model show

Načtení cílového modelu nebo definice modelu

 Rozšíření GA
az dt model update

Aktualizuje metadata modelu. V současné době lze model dekompisovat pouze.

 Rozšíření GA

az dt model create

Nahraje jeden nebo více modelů.

--models může být vložený json nebo cesta k souboru. Velikost vstupní sady modelů (ontologie) je omezená maximálním počtem modelů, které může instance DT uložit (výchozí hodnota je 1 0000 modelů).

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

Příklady

Hromadně nahrajte všechny soubory modelu .json nebo .dtdl z cílového adresáře. Zpracování modelu je rekurzivní.

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

Nahrajte vložený nebo z cesty k souboru json modelu.

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

Povinné parametry

--dt-name --dtn -n

Název instance služby Digital Twins nebo název hostitele Pokud je zadaný název instance, uživatelské předplatné se nejprve dotazuje na cílovou instanci, aby načetl název hostitele. Pokud je zadaný název hostitele, dotaz předplatného se přeskočí a zadaná hodnota se použije k následné interakci.

Volitelné parametry

--failure-policy --fp

Označuje zásadu selhání, když dojde k chybě při zpracování dávky modelů. V režimu Vrácení zpět se odstraní všechny modely vytvořené v předchozích dávkách po jednom. Pokud je vybrána možnost Žádné, modely vytvořené v předchozích dávkách se z instance DT neodstraní.

přijímané hodnoty: None, Rollback
výchozí hodnota: Rollback
--fd --from-directory

Soubory modelu JSON adresáře budou analyzovány. Poznámka: Modely se vytvářejí atomicky, pokud adresář obsahuje 250 nebo menší modely, a proto v případě chyby se žádný z modelů nevytvořil. Vstupní sada modelů je blokovaná a vytvořená v dávkách, pokud má adresář více než 250 modelů (limit rozhraní API). V případě chyby při zpracování dávky se chování určuje parametrem --failure-policy.

--max-models-per-batch --mmpb
Experimentální

Maximální velikost modelu na dávku při vytváření více než 250 modelů. Snižte toto číslo, abyste zabránili chybě DTDLParser.

výchozí hodnota: 30
--models

Vložený model JSON nebo cesta k souboru JSON modelu Poznámka: Modely se vytvářejí atomicky, pokud json modelu obsahuje 250 nebo menší modely, a proto v případě chyby se žádný z modelů nevytvořil. Vstupní sada modelů je blokovaná a vytvořená v dávkách, pokud má JSON modelu více než 250 modelů (limit rozhraní API). V případě chyby při zpracování dávky se chování určuje parametrem --failure-policy.

--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az dt model delete

Odstraňte model. Model lze odstranit pouze v případě, že na něj odkazují žádné jiné modely.

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

Příklady

Odstranění cílového modelu

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

Povinné parametry

--dt-name --dtn -n

Název instance služby Digital Twins nebo název hostitele Pokud je zadaný název instance, uživatelské předplatné se nejprve dotazuje na cílovou instanci, aby načetl název hostitele. Pokud je zadaný název hostitele, dotaz předplatného se přeskočí a zadaná hodnota se použije k následné interakci.

--dtmi --model-id -m

ID modelu Digital Twins. Příklad: dtmi:com:example:Room;2.

Volitelné parametry

--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az dt model delete-all

Odstraňte všechny modely v instanci služby Digital Twins.

Konfigurace dvojčat nejsou ovlivněné, ale bez definic modelu mohou být přerušené.

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

Příklady

Odstraňte všechny modely.

az dt model delete-all -n {instance_or_hostname}

Povinné parametry

--dt-name --dtn -n

Název instance služby Digital Twins nebo název hostitele Pokud je zadaný název instance, uživatelské předplatné se nejprve dotazuje na cílovou instanci, aby načetl název hostitele. Pokud je zadaný název hostitele, dotaz předplatného se přeskočí a zadaná hodnota se použije k následné interakci.

Volitelné parametry

--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--yes -y

Nezotvádejte výzvu k potvrzení.

výchozí hodnota: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az dt model list

Výpis metadat modelu, definic a závislostí

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

Příklady

Výpis metadat modelu

az dt model list -n {instance_or_hostname}

Výpis definic modelů

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

Uveďte závislosti konkrétních před existujících modelů. Oddělte hodnoty dtmi mezerami.

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

Povinné parametry

--dt-name --dtn -n

Název instance služby Digital Twins nebo název hostitele Pokud je zadaný název instance, uživatelské předplatné se nejprve dotazuje na cílovou instanci, aby načetl název hostitele. Pokud je zadaný název hostitele, dotaz předplatného se přeskočí a zadaná hodnota se použije k následné interakci.

Volitelné parametry

--def --definition

Operace načte definici modelu.

přijímané hodnoty: false, true
výchozí hodnota: False
--dependencies-for

Sada modelů, které budou mít načtené jejich závislosti. Pokud tento parametr vynecháte, načtou se všechny modely. Formát je prázdný seznam oddělený mezerami.

--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az dt model show

Načtení cílového modelu nebo definice modelu

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

Příklady

Zobrazit metadata modelu

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

Zobrazit metadata a definici modelu

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

Povinné parametry

--dt-name --dtn -n

Název instance služby Digital Twins nebo název hostitele Pokud je zadaný název instance, uživatelské předplatné se nejprve dotazuje na cílovou instanci, aby načetl název hostitele. Pokud je zadaný název hostitele, dotaz předplatného se přeskočí a zadaná hodnota se použije k následné interakci.

--dtmi --model-id -m

ID modelu Digital Twins. Příklad: dtmi:com:example:Room;2.

Volitelné parametry

--def --definition

Operace načte definici modelu.

přijímané hodnoty: false, true
výchozí hodnota: False
--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az dt model update

Aktualizuje metadata modelu. V současné době lze model dekompisovat pouze.

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

Příklady

Dekódování cílového modelu

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

Povinné parametry

--dt-name --dtn -n

Název instance služby Digital Twins nebo název hostitele Pokud je zadaný název instance, uživatelské předplatné se nejprve dotazuje na cílovou instanci, aby načetl název hostitele. Pokud je zadaný název hostitele, dotaz předplatného se přeskočí a zadaná hodnota se použije k následné interakci.

--dtmi --model-id -m

ID modelu Digital Twins. Příklad: dtmi:com:example:Room;2.

Volitelné parametry

--decommission

Označuje záměr vyřadit cílový model z provozu.

přijímané hodnoty: false, true
--resource-group -g

Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.