az dt twin relationship

Примечание.

Эта ссылка является частью расширения Azure-iot для Azure CLI (версия 2.46.0 или более поздней). Расширение автоматически установит первый раз, когда вы запускаете команду az dt twin relationship . Подробнее о расширениях.

Управление и настройка связей цифровых двойников экземпляра Digital Twins.

Команды

Имя	Описание	Тип	Состояние
az dt twin relationship create	Создайте связь между исходными и целевыми цифровыми двойниками.	Расширение	Общедоступная версия
az dt twin relationship delete	Удаление связи цифрового двойника в экземпляре Digital Twins.	Расширение	Общедоступная версия
az dt twin relationship delete-all	Удаляет все связи цифровых двойников в экземпляре Digital Twins, включая входящие связи.	Расширение	Общедоступная версия
az dt twin relationship list	Перечисление связей цифрового двойника.	Расширение	Общедоступная версия
az dt twin relationship show	Отображение сведений о связи цифрового двойника.	Расширение	Общедоступная версия
az dt twin relationship update	Обновляет свойства связи между двумя цифровыми двойниками с помощью спецификации исправления JSON.	Расширение	Общедоступная версия

az dt twin relationship create

Создайте связь между исходными и целевыми цифровыми двойниками.

--properties может содержать встроенный код JSON или путь к файлу.

az dt twin relationship create --dt-name
                               --kind
                               --relationship-id
                               --source
                               --target
                               [--if-none-match]
                               [--properties]
                               [--resource-group]

Примеры

Создайте связь между двумя цифровыми двойниками.

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

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

Создайте связь с инициализированными свойствами между двумя цифровыми двойниками.

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"}'

Обязательные параметры

--dt-name --dtn -n

Имя экземпляра Digital Twins или имя узла. Если указано имя экземпляра, подписка пользователя сначала запрашивается для целевого экземпляра, чтобы получить имя узла. Если указано имя узла, запрос подписки пропускается, а предоставленное значение используется для последующего взаимодействия.

--kind --relationship

Имя или тип связи. Например: "contains".

--relationship-id -r

Идентификатор связи.

--source --twin-id -t

Идентификатор исходного двойника для связи.

--target --target-twin-id

Идентификатор целевого двойника для связи.

Необязательные параметры

--if-none-match

Указывает, что операция создания должна завершиться ошибкой, если существующий двойник с тем же идентификатором существует.

значение по умолчанию: False

--properties -p

Начальные значения свойств для создания экземпляра связи цифрового двойника. Укажите путь к файлу или встроенный JSON.

--resource-group -g

Группа ресурсов экземпляра Digital Twins. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az dt twin relationship delete

Удаление связи цифрового двойника в экземпляре Digital Twins.

az dt twin relationship delete --dt-name
                               --relationship-id
                               --source
                               [--etag]
                               [--resource-group]

Примеры

Удаление связи цифрового двойника.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}

Удалите связь цифрового двойника с помощью etag.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --etag {etag}

Обязательные параметры

--dt-name --dtn -n

Имя экземпляра Digital Twins или имя узла. Если указано имя экземпляра, подписка пользователя сначала запрашивается для целевого экземпляра, чтобы получить имя узла. Если указано имя узла, запрос подписки пропускается, а предоставленное значение используется для последующего взаимодействия.

--relationship-id -r

Идентификатор связи.

--source --twin-id -t

Идентификатор исходного двойника для связи.

Необязательные параметры

--etag -e

Значение тега сущности. Команда будет выполнена успешно, если etag соответствует текущему etag для ресурса.

--resource-group -g

Группа ресурсов экземпляра Digital Twins. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az dt twin relationship delete-all

Удаляет все связи цифровых двойников в экземпляре Digital Twins, включая входящие связи.

az dt twin relationship delete-all --dt-name
                                   [--resource-group]
                                   [--source]
                                   [--yes]

Примеры

Удалите все связи цифровых двойников, связанные с двойником.

az dt twin relationship delete-all -n {instance_or_hostname} --twin-id {twin_id}

Удалите все связи цифровых двойников в рамках инстастаса Digital Twins.

az dt twin relationship delete-all -n {instance_or_hostname}

Обязательные параметры

--dt-name --dtn -n

Имя экземпляра Digital Twins или имя узла. Если указано имя экземпляра, подписка пользователя сначала запрашивается для целевого экземпляра, чтобы получить имя узла. Если указано имя узла, запрос подписки пропускается, а предоставленное значение используется для последующего взаимодействия.

Необязательные параметры

--resource-group -g

Группа ресурсов экземпляра Digital Twins. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--source --twin-id -t

Идентификатор исходного двойника для связи.

--yes -y

Не запрашивать подтверждение.

значение по умолчанию: False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az dt twin relationship list

Перечисление связей цифрового двойника.

az dt twin relationship list --dt-name
                             --source
                             [--incoming {false, true}]
                             [--kind]
                             [--resource-group]

Примеры

Вывод списка исходящих связей цифрового двойника.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id}

Вывод списка исходящих связей цифрового двойника и фильтра по связи "содержит"

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains

Вывод списка входящих связей цифрового двойника.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --incoming

Вывод списка входящих связей цифрового двойника и фильтра по связи "содержит".

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains --incoming

Обязательные параметры

--dt-name --dtn -n

Имя экземпляра Digital Twins или имя узла. Если указано имя экземпляра, подписка пользователя сначала запрашивается для целевого экземпляра, чтобы получить имя узла. Если указано имя узла, запрос подписки пропускается, а предоставленное значение используется для последующего взаимодействия.

--source --twin-id -t

Идентификатор исходного двойника для связи.

Необязательные параметры

--incoming

Извлекает все входящие связи для цифрового двойника.

допустимые значения: false, true

значение по умолчанию: False

--kind --relationship

Отфильтруйте результат по типу связи.

--resource-group -g

Группа ресурсов экземпляра Digital Twins. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az dt twin relationship show

Отображение сведений о связи цифрового двойника.

az dt twin relationship show --dt-name
                             --relationship-id
                             --source
                             [--resource-group]

Примеры

Отображение сведений о связи цифрового двойника.

az dt twin relationship show -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}

Обязательные параметры

--dt-name --dtn -n

Имя экземпляра Digital Twins или имя узла. Если указано имя экземпляра, подписка пользователя сначала запрашивается для целевого экземпляра, чтобы получить имя узла. Если указано имя узла, запрос подписки пропускается, а предоставленное значение используется для последующего взаимодействия.

--relationship-id -r

Идентификатор связи.

--source --twin-id -t

Идентификатор исходного двойника для связи.

Необязательные параметры

--resource-group -g

Группа ресурсов экземпляра Digital Twins. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az dt twin relationship update

Обновляет свойства связи между двумя цифровыми двойниками с помощью спецификации исправления JSON.

Операции ограничены добавлением, заменой и удалением.

az dt twin relationship update --dt-name
                               --json-patch
                               --relationship-id
                               --source
                               [--etag]
                               [--resource-group]

Примеры

Обновите связь цифрового двойника с помощью спецификации исправлений 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}'

Обновление связи цифрового двойника с помощью спецификации исправлений JSON и использования 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}

Обновите связь цифрового двойника с помощью спецификации исправлений 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"]}
]'

Обновите связь цифрового двойника с помощью спецификации исправлений JSON, определенной в файле.

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

Обязательные параметры

--dt-name --dtn -n

Имя экземпляра Digital Twins или имя узла. Если указано имя экземпляра, подписка пользователя сначала запрашивается для целевого экземпляра, чтобы получить имя узла. Если указано имя узла, запрос подписки пропускается, а предоставленное значение используется для последующего взаимодействия.

--json-patch --patch

Спецификация обновления, описанная в формате JSON-patch. Обновления значений свойств и $model элементов могут происходить в том же запросе. Операции ограничены добавлением, заменой и удалением. Укажите путь к файлу или встроенный JSON.

--relationship-id -r

Идентификатор связи.

--source --twin-id -t

Идентификатор исходного двойника для связи.

Необязательные параметры

--etag -e

Значение тега сущности. Команда будет выполнена успешно, если etag соответствует текущему etag для ресурса.

--resource-group -g

Группа ресурсов экземпляра Digital Twins. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.