az dt model

Note

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.67.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.	Extension	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.	Extension	ogólna dostępność
az dt model delete-all	Usuń wszystkie modele w wystąpieniu usługi Digital Twins.	Extension	ogólna dostępność
az dt model list	Wyświetlanie listy metadanych, definicji i zależności modelu.	Extension	ogólna dostępność
az dt model show	Pobierz docelowy model lub definicję modelu.	Extension	ogólna dostępność
az dt model update	Aktualizuje metadane modelu. Obecnie model można dekommisować tylko.	Extension	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 --dtn
                   [--failure-policy --fp {None, Rollback}]
                   [--fd --from-directory]
                   [--max-models-per-batch --mmpb]
                   [--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}

Wymagane parametry

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

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

Własność	Wartość
Grupa parametrów:	Models Input Arguments
Wartość domyślna:	Rollback
Akceptowane wartości:	None, 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 & 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.

Własność	Wartość
Grupa parametrów:	Models Input Arguments

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

Eksperymentalny

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

Własność	Wartość
Grupa parametrów:	Models Input Arguments
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 & 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.

Własność	Wartość
Grupa parametrów:	Models Input Arguments

--resource-group -g

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

Parametry globalne

--debug

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

Własność	Wartość
Wartość domyślna:	False

--help -h

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

--only-show-errors

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

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--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 az account set -s NAME_OR_ID.

--verbose

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

Własność	Wartość
Wartość domyślna:	False

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 --dtn
                   --dtmi --model-id
                   [--resource-group]

Przykłady

Usuń model docelowy.

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

Wymagane parametry

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--resource-group -g

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

Parametry globalne

--debug

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

Własność	Wartość
Wartość domyślna:	False

--help -h

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

--only-show-errors

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

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--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 az account set -s NAME_OR_ID.

--verbose

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

Własność	Wartość
Wartość domyślna:	False

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 --dtn
                       [--resource-group]
                       [--yes]

Przykłady

Usuń wszystkie modele.

az dt model delete-all -n {instance_or_hostname}

Wymagane parametry

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--resource-group -g

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

--yes -y

Nie monituj o potwierdzenie.

Własność	Wartość
Wartość domyślna:	False

Parametry globalne

--debug

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

Własność	Wartość
Wartość domyślna:	False

--help -h

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

--only-show-errors

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

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--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 az account set -s NAME_OR_ID.

--verbose

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

Własność	Wartość
Wartość domyślna:	False

az dt model list

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

az dt model list --dt-name --dtn
                 [--def --definition {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}

Wymagane parametry

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--def --definition

Operacja pobierze definicję modelu.

Własność	Wartość
Wartość domyślna:	False
Akceptowane wartości:	false, true

--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 az configure --defaults group={name}.

Parametry globalne

--debug

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

Własność	Wartość
Wartość domyślna:	False

--help -h

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

--only-show-errors

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

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--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 az account set -s NAME_OR_ID.

--verbose

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

Własność	Wartość
Wartość domyślna:	False

az dt model show

Pobierz docelowy model lub definicję modelu.

az dt model show --dt-name --dtn
                 --dtmi --model-id
                 [--def --definition {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

Wymagane parametry

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--def --definition

Operacja pobierze definicję modelu.

Własność	Wartość
Wartość domyślna:	False
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 az configure --defaults group={name}.

Parametry globalne

--debug

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

Własność	Wartość
Wartość domyślna:	False

--help -h

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

--only-show-errors

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

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--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 az account set -s NAME_OR_ID.

--verbose

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

Własność	Wartość
Wartość domyślna:	False

az dt model update

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

az dt model update --dt-name --dtn
                   --dtmi --model-id
                   [--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

Wymagane parametry

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--decommission

Wskazuje zamiar zlikwidowania modelu docelowego.

Własność	Wartość
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 az configure --defaults group={name}.

Parametry globalne

--debug

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

Własność	Wartość
Wartość domyślna:	False

--help -h

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

--only-show-errors

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

Własność	Wartość
Wartość domyślna:	False

--output -o

Format danych wyjściowych.

Własność	Wartość
Wartość domyślna:	json
Akceptowane wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--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 az account set -s NAME_OR_ID.

--verbose

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

Własność	Wartość
Wartość domyślna:	False