Sdílet prostřednictvím


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

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

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.

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

Vlastnost Hodnota
Skupina parametrů: Models Input Arguments
Default value: Rollback
Přípustné hodnoty: None, 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á & 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
--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.

Vlastnost Hodnota
Skupina parametrů: Models Input Arguments
Default value: 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á & 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
--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í.

Vlastnost Hodnota
Default value: False
--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--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.

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

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

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.

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

Vlastnost Hodnota
Default value: False
--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--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.

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

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

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.

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

Nevyzývejte k potvrzení.

Vlastnost Hodnota
Default value: False
Globální parametry
--debug

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

Vlastnost Hodnota
Default value: False
--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--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.

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

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

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.

--def --definition

Operace načte definici modelu.

Vlastnost Hodnota
Default value: False
Přípustné hodnoty: false, true
--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í.

Vlastnost Hodnota
Default value: False
--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--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.

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

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

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.

--def --definition

Operace načte definici modelu.

Vlastnost Hodnota
Default value: False
Přípustné 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í.

Vlastnost Hodnota
Default value: False
--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--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.

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

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

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.

--decommission

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

Vlastnost Hodnota
Přípustné 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í.

Vlastnost Hodnota
Default value: False
--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Vlastnost Hodnota
Default value: False