Dela via

az dt model

  • Referens

Kommentar

Den här referensen är en del av azure-iot-tillägget för Azure CLI (version 2.46.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az dt-modellkommando . Läs mer om tillägg.

Hantera DTDL-modeller och definitioner på en Digital Twins-instans.

Kommandon

Name Description Typ Status
az dt model create

Laddar upp en eller flera modeller.

 Anknytning Allmän tillgänglighet
az dt model delete

Ta bort en modell. En modell kan bara tas bort om inga andra modeller refererar till den.

 Anknytning Allmän tillgänglighet
az dt model delete-all

Ta bort alla modeller i en Digital Twins-instans.

 Anknytning Allmän tillgänglighet
az dt model list

Lista modellmetadata, definitioner och beroenden.

 Anknytning Allmän tillgänglighet
az dt model show

Hämta en målmodell eller modelldefinition.

 Anknytning Allmän tillgänglighet
az dt model update

Uppdaterar metadata för en modell. För närvarande kan en modell endast tas bort.

 Anknytning Allmän tillgänglighet

az dt model create

Laddar upp en eller flera modeller.

--models kan vara infogad json eller filsökväg. Storleken på indatamodelluppsättningen (ontologi) begränsas av det maximala antalet modeller som DT-instansen kan lagra (standard är 1 0000 modeller).

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

Exempel

Massuppladdning av alla .json- eller .dtdl-modellfiler från en målkatalog. Modellbearbetningen är rekursiv.

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

Ladda upp modell json infogad eller från filsökväg.

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

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

Valfria parametrar

--failure-policy --fp

Anger felprincipen när ett fel inträffar när en modellbatch bearbetas. I återställningsläget tas alla modeller som skapats i tidigare batchar bort en i taget. När modellerna som skapats i tidigare batchar har valts som "Ingen" tas de inte bort från DT-instansen.

accepterade värden: None, Rollback
standardvärde: Rollback
--fd --from-directory

Katalog-JSON-modellfilerna parsas från. Obs! Modeller skapas atomiskt när katalogen innehåller 250 eller mindre modeller, vilket innebär att om det uppstår ett fel skapas ingen av modellerna. Indatamodelluppsättningen segmenteras och skapas i batchar när katalogen har fler än 250 modeller (API-gräns). Om ett fel uppstår vid bearbetning av en batch bestäms beteendet av parametern --failure-policy.

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

Den maximala modellstorleken per batch när du skapar fler än 250 modeller. Minska det här antalet för att förhindra ett DTDLParser-fel.

standardvärde: 30
--models

Infogad modell-JSON eller filsökväg till modell-JSON. Obs! Modeller skapas atomiskt när modell-JSON innehåller 250 eller mindre modeller, vilket innebär att om det uppstår ett fel skapas ingen av modellerna. Indatamodelluppsättningen segmenteras och skapas i batchar när modell-JSON har fler än 250 modeller (API-gräns). Om ett fel uppstår vid bearbetning av en batch bestäms beteendet av parametern --failure-policy.

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt model delete

Ta bort en modell. En modell kan bara tas bort om inga andra modeller refererar till den.

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

Exempel

Ta bort en målmodell.

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

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--dtmi --model-id -m

Digital Twins modell-ID. Exempel: dtmi:com:example:Room;2.

Valfria parametrar

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt model delete-all

Ta bort alla modeller i en Digital Twins-instans.

Twins-konfigurationer påverkas inte men kan brytas utan modelldefinitioner.

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

Exempel

Ta bort alla modeller.

az dt model delete-all -n {instance_or_hostname}

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

Valfria parametrar

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--yes -y

Fråga inte efter bekräftelse.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt model list

Lista modellmetadata, definitioner och beroenden.

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

Exempel

Lista modellmetadata

az dt model list -n {instance_or_hostname}

Lista modelldefinitioner

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

Visa en lista över beroenden för vissa befintliga modeller. Blankstegsavgränsade dtmi-värden.

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

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

Valfria parametrar

--def --definition

Åtgärden hämtar modelldefinitionen.

accepterade värden: false, true
standardvärde: False
--dependencies-for

Den uppsättning modeller som ska hämta deras beroenden. Om det utelämnas hämtas alla modeller. Format är en blankstegsavgränsad lista.

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt model show

Hämta en målmodell eller modelldefinition.

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

Exempel

Visa modellmetadata

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

Visa modellmetadata och definition

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

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--dtmi --model-id -m

Digital Twins modell-ID. Exempel: dtmi:com:example:Room;2.

Valfria parametrar

--def --definition

Åtgärden hämtar modelldefinitionen.

accepterade värden: false, true
standardvärde: False
--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt model update

Uppdaterar metadata för en modell. För närvarande kan en modell endast tas bort.

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

Exempel

Decommision en målmodell

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

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--dtmi --model-id -m

Digital Twins modell-ID. Exempel: dtmi:com:example:Room;2.

Valfria parametrar

--decommission

Anger avsikten att inaktivera en målmodell.

accepterade värden: false, true
--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.