az dt model

Uwaga

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.30.0 lub nowsza). Rozszerzenie automatycznie zainstaluje polecenie az dt model po raz pierwszy. Dowiedz się więcej o rozszerzeniach.

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

Polecenia

az dt model create

Przekazuje co najmniej jeden model. W przypadku wystąpienia jakiegokolwiek błędu nie są przekazywane żadne modele.

az dt model delete

Usuwanie modelu. Model można usunąć tylko wtedy, gdy nie odwołuje się do niego żaden inny model.

az dt model delete-all

Usuń wszystkie modele w wystąpieniu usługi Digital Twins. Konfiguracje bliźniaczych reprezentacji nie mają wpływu, ale mogą zostać przerwane bez definicji modelu.

az dt model list

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

az dt model show

Pobierz docelowy model lub definicję modelu.

az dt model update

Aktualizacje metadanych modelu. Obecnie model można dekompmisować tylko.

az dt model create

Przekazuje co najmniej jeden model. W przypadku wystąpienia jakiegokolwiek błędu nie są przekazywane żadne modele.

--models mogą być wbudowanym plikiem json lub ścieżką pliku.

az dt model create --dt-name
                   [--fd]
                   [--models]
                   [--resource-group]

Przykłady

Zbiorczo przekaż wszystkie pliki modelu json lub dtdl z katalogu docelowego. Przetwarzanie modelu jest rekursywne.

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 o wystąpienie docelowe w celu pobrania nazwy hosta. Jeśli podano nazwę hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

Parametry opcjonalne

--fd --from-directory

Pliki modelu JSON katalogu zostaną przeanalizowane.

--models

Wbudowany kod JSON modelu lub ścieżka pliku do modelu JSON.

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

az dt model delete

Usuwanie modelu. Model można usunąć tylko wtedy, gdy nie odwołuje się do niego żaden inny model.

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 o wystąpienie docelowe w celu pobrania nazwy hosta. Jeśli podano nazwę 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>.

az dt model delete-all

Usuń wszystkie modele w wystąpieniu usługi Digital Twins. Konfiguracje bliźniaczych reprezentacji nie mają wpływu, ale mogą zostać przerwane 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 o wystąpienie docelowe w celu pobrania nazwy hosta. Jeśli podano nazwę 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.

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 wstępnie 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 o wystąpienie docelowe w celu pobrania nazwy hosta. Jeśli podano nazwę 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
--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>.

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 o wystąpienie docelowe w celu pobrania nazwy hosta. Jeśli podano nazwę 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
--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>.

az dt model update

Aktualizacje metadanych modelu. Obecnie model można dekompmisować tylko.

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

Przykłady

Dekommisja 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 o wystąpienie docelowe w celu pobrania nazwy hosta. Jeśli podano nazwę 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 intencję likwidacji 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>.