az dt twin relationship
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 twin relationship. Dowiedz się więcej o rozszerzeniach.
Zarządzanie i konfigurowanie relacji cyfrowej reprezentacji bliźniaczej wystąpienia usługi Digital Twins.
Polecenia
| Nazwa | Opis | Typ | Stan |
|---|---|---|---|
| az dt twin relationship create |
Utwórz relację między źródłowymi i docelowymi cyfrowymi reprezentacjami bliźniaczymi. |
Extension | ogólna dostępność |
| az dt twin relationship delete |
Usuń relację cyfrowej reprezentacji bliźniaczej w wystąpieniu usługi Digital Twins. |
Extension | ogólna dostępność |
| az dt twin relationship delete-all |
Usuwa wszystkie relacje cyfrowej reprezentacji bliźniaczej w wystąpieniu usługi Digital Twins, w tym relacje przychodzące. |
Extension | ogólna dostępność |
| az dt twin relationship list |
Wyświetlanie listy relacji cyfrowej reprezentacji bliźniaczej. |
Extension | ogólna dostępność |
| az dt twin relationship show |
Pokaż szczegóły relacji cyfrowej reprezentacji bliźniaczej. |
Extension | ogólna dostępność |
| az dt twin relationship update |
Aktualizuje właściwości relacji między dwiema cyfrowymi reprezentacjami bliźniaczymi za pośrednictwem specyfikacji poprawek JSON. |
Extension | ogólna dostępność |
az dt twin relationship create
Utwórz relację między źródłowymi i docelowymi cyfrowymi reprezentacjami bliźniaczymi.
--properties może być wbudowanym plikiem JSON lub ścieżką pliku.
az dt twin relationship create --dt-name --dtn
--kind --relationship
--relationship-id
--source --twin-id
--target --target-twin-id
[--if-none-match]
[--properties]
[--resource-group]
Przykłady
Utwórz relację między dwiema cyfrowymi reprezentacjami bliźniaczymi.
az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id}
Tworzenie relacji między dwiema cyfrowymi reprezentacjami bliźniaczymi z tagiem if-none-match
az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --if-none-match
Utwórz relację z zainicjowanymi właściwościami między dwiema reprezentacjami cyfrowymi.
az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --properties '{"ownershipUser": "me", "ownershipDepartment": "Computer Science"}'
Parametry wymagane
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.
Nazwa lub rodzaj relacji. Na przykład: "contains".
Identyfikator relacji.
Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.
Identyfikator docelowej reprezentacji bliźniaczej dla relacji.
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.
Wskazuje, że operacja tworzenia powinna zakończyć się niepowodzeniem, jeśli istnieje istniejąca reprezentacja bliźniaczyna o tym samym identyfikatorze.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Początkowe wartości właściwości służące do tworzenia wystąpienia relacji cyfrowej reprezentacji bliźniaczej. Podaj ścieżkę pliku lub wbudowany kod JSON.
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
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az dt twin relationship delete
Usuń relację cyfrowej reprezentacji bliźniaczej w wystąpieniu usługi Digital Twins.
az dt twin relationship delete --dt-name --dtn
--relationship-id
--source --twin-id
[--etag]
[--resource-group]
Przykłady
Usuń relację cyfrowej reprezentacji bliźniaczej.
az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}
Usuń relację cyfrowej reprezentacji bliźniaczej przy użyciu elementu etag.
az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --etag {etag}
Parametry wymagane
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.
Identyfikator relacji.
Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.
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.
Wartość tagu jednostki. Polecenie powiedzie się, jeśli element etag pasuje do bieżącego elementu etag dla zasobu.
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
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az dt twin relationship delete-all
Usuwa wszystkie relacje cyfrowej reprezentacji bliźniaczej w wystąpieniu usługi Digital Twins, w tym relacje przychodzące.
az dt twin relationship delete-all --dt-name --dtn
[--resource-group]
[--source --twin-id]
[--yes]
Przykłady
Usuń wszystkie relacje cyfrowej reprezentacji bliźniaczej skojarzone z reprezentacją bliźniaczą.
az dt twin relationship delete-all -n {instance_or_hostname} --twin-id {twin_id}
Usuń wszystkie relacje cyfrowej reprezentacji bliźniaczej w ramach instace usługi Digital Twins.
az dt twin relationship delete-all -n {instance_or_hostname}
Parametry wymagane
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.
Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group={name}.
Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.
Nie monituj o potwierdzenie.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az dt twin relationship list
Wyświetlanie listy relacji cyfrowej reprezentacji bliźniaczej.
az dt twin relationship list --dt-name --dtn
--source --twin-id
[--incoming {false, true}]
[--kind --relationship]
[--resource-group]
Przykłady
Wyświetlanie listy wychodzących relacji cyfrowej reprezentacji bliźniaczej.
az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id}
Wyświetlanie listy wychodzących relacji cyfrowej reprezentacji bliźniaczej i filtrowanie relacji "contains"
az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains
Wyświetlanie listy przychodzących relacji cyfrowej reprezentacji bliźniaczej.
az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --incoming
Wyświetlanie listy przychodzących relacji cyfrowej reprezentacji bliźniaczej i filtrowanie relacji "contains".
az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains --incoming
Parametry wymagane
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.
Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.
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.
Pobiera wszystkie relacje przychodzące dla cyfrowej reprezentacji bliźniaczej.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
| Dopuszczalne wartości: | false, true |
Filtruj wynik według rodzaju relacji.
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
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az dt twin relationship show
Pokaż szczegóły relacji cyfrowej reprezentacji bliźniaczej.
az dt twin relationship show --dt-name --dtn
--relationship-id
--source --twin-id
[--resource-group]
Przykłady
Pokaż szczegóły relacji cyfrowej reprezentacji bliźniaczej.
az dt twin relationship show -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}
Parametry wymagane
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.
Identyfikator relacji.
Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.
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.
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
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az dt twin relationship update
Aktualizuje właściwości relacji między dwiema cyfrowymi reprezentacjami bliźniaczymi za pośrednictwem specyfikacji poprawek JSON.
Operacje są ograniczone do dodawania, zastępowania i usuwania.
az dt twin relationship update --dt-name --dtn
--json-patch --patch
--relationship-id
--source --twin-id
[--etag]
[--resource-group]
Przykłady
Aktualizowanie relacji cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.
az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'
Aktualizowanie relacji cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON i używanie narzędzia etag.
az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}' --etag {etag}
Aktualizowanie relacji cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.
az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '[
{"op":"replace", "path":"/Temperature", "value": 20.5},
{"op":"add", "path":"/Areas", "value": ["ControlSystem"]}
]'
Aktualizowanie relacji cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawki JSON zdefiniowanej w pliku.
az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch ./my/patch/document.json
Parametry wymagane
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.
Specyfikacja aktualizacji opisana przez JSON-patch. Aktualizacje wartości właściwości i $model elementów mogą wystąpić w tym samym żądaniu. Operacje są ograniczone do dodawania, zastępowania i usuwania. Podaj ścieżkę pliku lub wbudowany kod JSON.
Identyfikator relacji.
Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.
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.
Wartość tagu jednostki. Polecenie powiedzie się, jeśli element etag pasuje do bieżącego elementu etag dla zasobu.
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
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |