az dt model

Uwaga

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.46.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az dt model . Dowiedz się więcej o rozszerzeniach.

Zarządzanie modelami i definicjami DTDL w wystąpieniu usługi Digital Twins.

Polecenia

Nazwa	Opis	Typ	Stan
az dt model create	Przekazuje co najmniej jeden model.	Numer wewnętrzny	Ogólna dostępność
az dt model delete	Usuwanie modelu. Model można usunąć tylko wtedy, gdy nie odwołują się do niego żadne inne modele.	Numer wewnętrzny	Ogólna dostępność
az dt model delete-all	Usuń wszystkie modele w wystąpieniu usługi Digital Twins.	Numer wewnętrzny	Ogólna dostępność
az dt model list	Wyświetlanie listy metadanych, definicji i zależności modelu.	Numer wewnętrzny	Ogólna dostępność
az dt model show	Pobierz docelowy model lub definicję modelu.	Numer wewnętrzny	Ogólna dostępność
az dt model update	Aktualizuje metadane modelu. Obecnie model można dekommisować tylko.	Numer wewnętrzny	Ogólna dostępność

az dt model create

Przekazuje co najmniej jeden model.

--modele mogą być wbudowanym plikiem json lub ścieżką pliku. Rozmiar zestawu modeli wejściowych (ontologia) jest ograniczony przez maksymalną liczbę modeli, które może przechowywać wystąpienie DT (domyślnie to 10000 modeli).

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

Przykłady

Zbiorcze przekazywanie wszystkich plików modelu .json lub dtdl z katalogu docelowego. Przetwarzanie modelu jest cyklicznego.

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

Przekaż kod json modelu w tekście lub ze ścieżki pliku.

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

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

Parametry opcjonalne

--failure-policy --fp

Wskazuje zasady niepowodzenia, gdy wystąpi błąd podczas przetwarzania partii modeli. W trybie wycofywania wszystkie modele utworzone w poprzednich partiach są usuwane pojedynczo. Po wybraniu opcji "Brak" modele utworzone w poprzednich partiach nie zostaną usunięte z wystąpienia DT.

akceptowane wartości: None, Rollback

wartość domyślna: Rollback

--fd --from-directory

Pliki modelu JSON katalogu zostaną przeanalizowane. Uwaga: Modele są tworzone niepodziecznie, gdy katalog zawiera 250 lub mniej modeli, dlatego w przypadku błędu żaden z modeli nie zostanie utworzony. Zestaw modeli wejściowych jest fragmentowany i tworzony w partiach, gdy katalog ma ponad 250 modeli (limit interfejsu API). W przypadku błędu przetwarzania partii zachowanie jest określane przez parametr --failure-policy.

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

Eksperymentalne

Maksymalny rozmiar modelu na partię podczas tworzenia ponad 250 modeli. Zmniejsz tę liczbę, aby zapobiec błędowi dtDLParser.

wartość domyślna: 30

--models

Wbudowany kod JSON modelu lub ścieżka pliku do modelu JSON. Uwaga: Modele są tworzone niepodzielnie, gdy model JSON zawiera 250 lub mniej modeli, dlatego w przypadku błędu żaden z modeli nie zostanie utworzony. Zestaw modeli wejściowych jest fragmentowany i tworzony w partiach, gdy model JSON ma ponad 250 modeli (limit interfejsu API). W przypadku błędu przetwarzania partii zachowanie jest określane przez parametr --failure-policy.

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc

wartość domyślna: json

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az dt model delete

Usuwanie modelu. Model można usunąć tylko wtedy, gdy nie odwołują się do niego żadne inne modele.

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

Przykłady

Usuń model docelowy.

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

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

--dtmi --model-id -m

Identyfikator modelu usługi Digital Twins. Przykład: dtmi:com:example:Room;2.

Parametry opcjonalne

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc

wartość domyślna: json

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az dt model delete-all

Usuń wszystkie modele w wystąpieniu usługi Digital Twins.

Konfiguracje reprezentacji bliźniaczych nie mają wpływu, ale mogą być uszkodzone bez definicji modelu.

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

Przykłady

Usuń wszystkie modele.

az dt model delete-all -n {instance_or_hostname}

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

Parametry opcjonalne

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--yes -y

Nie monituj o potwierdzenie.

wartość domyślna: False

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc

wartość domyślna: json

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az dt model list

Wyświetlanie listy metadanych, definicji i zależności modelu.

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

Przykłady

Wyświetlanie listy metadanych modelu

az dt model list -n {instance_or_hostname}

Wyświetlanie listy definicji modelu

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

Wyświetlanie listy zależności określonych wcześniej istniejących modeli. Odstęp oddziela wartości dtmi.

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

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

Parametry opcjonalne

--def --definition

Operacja pobierze definicję modelu.

akceptowane wartości: false, true

wartość domyślna: False

--dependencies-for

Zestaw modeli, które będą miały pobrane zależności. W przypadku pominięcia wszystkie modele zostaną pobrane. Format jest listą rozdzielaną odstępami.

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc

wartość domyślna: json

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az dt model show

Pobierz docelowy model lub definicję modelu.

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

Przykłady

Pokaż metadane modelu

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

Pokaż metadane i definicje modelu

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

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

--dtmi --model-id -m

Identyfikator modelu usługi Digital Twins. Przykład: dtmi:com:example:Room;2.

Parametry opcjonalne

--def --definition

Operacja pobierze definicję modelu.

akceptowane wartości: false, true

wartość domyślna: False

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc

wartość domyślna: json

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az dt model update

Aktualizuje metadane modelu. Obecnie model można dekommisować tylko.

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

Przykłady

Dekommision modelu docelowego

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

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

--dtmi --model-id -m

Identyfikator modelu usługi Digital Twins. Przykład: dtmi:com:example:Room;2.

Parametry opcjonalne

--decommission

Wskazuje zamiar zlikwidowania modelu docelowego.

akceptowane wartości: false, true

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc

wartość domyślna: json

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.