az dt twin relationship

참고

이 참조는 Azure CLI 대한 azure-iot 확장의 일부이며 버전 2.17.1 이상이 필요합니다. 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

관계 ID입니다.

--source --twin-id -t

관계의 원본 쌍 ID입니다.

--target --target-twin-id

관계의 대상 쌍 ID입니다.

선택적 매개 변수

--if-none-match

ID가 같은 기존 트윈이 있는 경우 만들기 작업이 실패함을 나타냅니다.

--properties -p

디지털 트윈 관계를 인스턴스화하기 위한 초기 속성 값입니다. 파일 경로 또는 인라인 JSON을 제공합니다.

--resource-group -g

인스턴스 리소스 그룹을 Digital Twins. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

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

관계 ID입니다.

--source --twin-id -t

관계의 원본 쌍 ID입니다.

선택적 매개 변수

--etag -e

엔터티 태그 값입니다. etag가 리소스에 대한 현재 etag와 일치하면 명령이 성공합니다.

--resource-group -g

인스턴스 리소스 그룹을 Digital Twins. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

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

관계의 원본 쌍 ID입니다.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

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}

디지털 트윈의 나가는 관계를 나열하고 'contains' 관계를 필터링합니다.

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

디지털 트윈의 들어오는 관계를 나열하고 'contains' 관계를 필터링합니다.

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

관계의 원본 쌍 ID입니다.

선택적 매개 변수

--incoming

디지털 트윈에 대해 들어오는 모든 관계를 검색합니다.

허용되는 값: false, true
--kind --relationship

관계 종류별로 결과를 필터링합니다.

--resource-group -g

인스턴스 리소스 그룹을 Digital Twins. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

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

관계 ID입니다.

--source --twin-id -t

관계의 원본 쌍 ID입니다.

선택적 매개 변수

--resource-group -g

인스턴스 리소스 그룹을 Digital Twins. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

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 패치에서 설명하는 업데이트 사양입니다. 속성 값 및 $model 요소에 대한 업데이트는 동일한 요청에서 발생할 수 있습니다. 작업은 추가, 바꾸기 및 제거로 제한됩니다. 파일 경로 또는 인라인 JSON을 제공합니다.

--relationship-id -r

관계 ID입니다.

--source --twin-id -t

관계의 원본 쌍 ID입니다.

선택적 매개 변수

--etag -e

엔터티 태그 값입니다. etag가 리소스에 대한 현재 etag와 일치하면 명령이 성공합니다.

--resource-group -g

인스턴스 리소스 그룹을 Digital Twins. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.