az dt model
Note
Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.67.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ů. |
Extension | GA |
| az dt model delete |
Odstraňte model. Model lze odstranit pouze v případě, že na něj odkazují žádné jiné modely. |
Extension | GA |
| az dt model delete-all |
Odstraňte všechny modely v instanci služby Digital Twins. |
Extension | GA |
| az dt model list |
Výpis metadat modelu, definic a závislostí |
Extension | GA |
| az dt model show |
Načtení cílového modelu nebo definice modelu |
Extension | GA |
| az dt model update |
Aktualizuje metadata modelu. V současné době lze model dekompisovat pouze. |
Extension | 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 --dtn
[--failure-policy --fp {None, Rollback}]
[--fd --from-directory]
[--max-models-per-batch --mmpb]
[--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
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
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
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í.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Models Input Arguments |
| Default value: | Rollback |
| Přípustné hodnoty: | None, Rollback |
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á & 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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Models Input Arguments |
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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Models Input Arguments |
| Default value: | 30 |
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á & 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.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Models Input Arguments |
Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group={name}.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
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 --dtn
--dtmi --model-id
[--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
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.
ID modelu Digital Twins. Příklad: dtmi:com:example:Room;2.
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group={name}.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
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 --dtn
[--resource-group]
[--yes]
Příklady
Odstraňte všechny modely.
az dt model delete-all -n {instance_or_hostname}
Povinné parametry
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
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group={name}.
Nevyzývejte k potvrzení.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az dt model list
Výpis metadat modelu, definic a závislostí
az dt model list --dt-name --dtn
[--def --definition {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
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
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Operace načte definici modelu.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
| Přípustné hodnoty: | false, true |
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.
Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group={name}.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az dt model show
Načtení cílového modelu nebo definice modelu
az dt model show --dt-name --dtn
--dtmi --model-id
[--def --definition {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
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.
ID modelu Digital Twins. Příklad: dtmi:com:example:Room;2.
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Operace načte definici modelu.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
| Přípustné hodnoty: | false, true |
Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group={name}.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az dt model update
Aktualizuje metadata modelu. V současné době lze model dekompisovat pouze.
az dt model update --dt-name --dtn
--dtmi --model-id
[--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
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.
ID modelu Digital Twins. Příklad: dtmi:com:example:Room;2.
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Označuje záměr vyřadit cílový model z provozu.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | false, true |
Skupina prostředků instance služby Digital Twins Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group={name}.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |