Udostępnij przez

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}

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany 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łaściwość Wartość
Grupa parametrów: Models Input Arguments
Domyślna wartość: Rollback
Dopuszczalne 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łaściwość Wartość
Grupa parametrów: Models Input Arguments
--max-models-per-batch --mmpb
Eksperymentalne

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

Właściwość Wartość
Grupa parametrów: Models Input Arguments
Domyślna wartość: 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łaściwość 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łaściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: 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"

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany 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łaściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: 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}

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany 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łaściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: 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}

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--def --definition

Operacja pobierze definicję modelu.

Właściwość Wartość
Domyślna wartość: False
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: 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

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--def --definition

Operacja pobierze definicję modelu.

Właściwość Wartość
Domyślna wartość: False
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: 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

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--decommission

Wskazuje zamiar zlikwidowania modelu docelowego.

Właściwość Wartość
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne 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łaściwość Wartość
Domyślna wartość: False