az dt model

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.