az dt model

참고

이 참조는 Azure CLI 대한 azure-iot 확장의 일부이며 버전 2.17.1 이상이 필요합니다. az dt model 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

Digital Twins 인스턴스에서 DTDL 모델 및 정의를 관리합니다.

명령

az dt model create

하나 이상의 모델을 업로드합니다. 오류가 발생하면 모델이 업로드되지 않습니다.

az dt model delete

모델을 삭제합니다. 모델을 참조하는 다른 모델이 없는 경우에만 모델을 삭제할 수 있습니다.

az dt model delete-all

Digital Twins 인스턴스 내의 모든 모델을 삭제합니다. 트윈 구성은 영향을 받지 않지만 모델 정의 없이는 손상될 수 있습니다.

az dt model list

모델 메타데이터, 정의 및 dependencies를 나열합니다.

az dt model show

대상 모델 또는 모델 정의를 검색합니다.

az dt model update

모델의 메타데이터를 업데이트합니다. 현재 모델은 커밋 해제만 가능합니다.

az dt model create

하나 이상의 모델을 업로드합니다. 오류가 발생하면 모델이 업로드되지 않습니다.

--models는 인라인 json 또는 파일 경로일 수 있습니다.

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

예제

대상 디렉터리에서 모든 .json 또는 .dtdl 모델 파일을 대량 업로드합니다. 모델 처리는 재귀적입니다.

az dt model create -n {instance_or_hostname} --from-directory {directory_path}

인라인 또는 파일 경로에서 모델 json을 업로드.

az dt model create -n {instance_or_hostname} --models {file_path_or_inline_json}

필수 매개 변수

--dt-name --dtn -n

인스턴스 이름 또는 호스트 이름을 Digital Twins. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값을 후속 상호 작용에 사용합니다.

선택적 매개 변수

--fd --from-directory

디렉터리 JSON 모델 파일은 구문 분석됩니다.

--models

모델 JSON에 대한 인라인 모델 JSON 또는 파일 경로입니다.

--resource-group -g

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

az dt model delete

모델을 삭제합니다. 모델을 참조하는 다른 모델이 없는 경우에만 모델을 삭제할 수 있습니다.

az dt model delete --dt-name
                   --dtmi
                   [--resource-group]

예제

대상 모델을 삭제합니다.

az dt model delete -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

필수 매개 변수

--dt-name --dtn -n

인스턴스 이름 또는 호스트 이름을 Digital Twins. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값을 후속 상호 작용에 사용합니다.

--dtmi --model-id -m

Digital Twins 모델 ID. 예: dtmi:com:example:Room;2.

선택적 매개 변수

--resource-group -g

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

az dt model delete-all

Digital Twins 인스턴스 내의 모든 모델을 삭제합니다. 트윈 구성은 영향을 받지 않지만 모델 정의 없이는 손상될 수 있습니다.

az dt model delete-all --dt-name
                       [--resource-group]
                       [--yes]

예제

모든 모델을 삭제합니다.

az dt model delete-all -n {instance_or_hostname}

필수 매개 변수

--dt-name --dtn -n

인스턴스 이름 또는 호스트 이름을 Digital Twins. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값을 후속 상호 작용에 사용합니다.

선택적 매개 변수

--resource-group -g

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

--yes -y

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

az dt model list

모델 메타데이터, 정의 및 dependencies를 나열합니다.

az dt model list --dt-name
                 [--def {false, true}]
                 [--dependencies-for]
                 [--resource-group]

예제

모델 메타데이터 나열

az dt model list -n {instance_or_hostname}

모델 정의 나열

az dt model list -n {instance_or_hostname} --definition

특정 기존 모델의 의존도를 나열합니다. 공백으로 구분된 dtmi 값입니다.

az dt model list -n {instance_or_hostname} --dependencies-for {model_id0} {model_id1}

필수 매개 변수

--dt-name --dtn -n

인스턴스 이름 또는 호스트 이름을 Digital Twins. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값을 후속 상호 작용에 사용합니다.

선택적 매개 변수

--def --definition

작업에서 모델 정의를 검색합니다.

허용되는 값: false, true
--dependencies-for

해당 dependencies를 검색할 모델 집합입니다. 생략하면 모든 모델이 검색됩니다. 형식은 공백으로 구분된 목록입니다.

--resource-group -g

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

az dt model show

대상 모델 또는 모델 정의를 검색합니다.

az dt model show --dt-name
                 --dtmi
                 [--def {false, true}]
                 [--resource-group]

예제

모델 메타데이터 표시

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

모델 메타데이터 및 정의 표시

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --definition

필수 매개 변수

--dt-name --dtn -n

인스턴스 이름 또는 호스트 이름을 Digital Twins. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값을 후속 상호 작용에 사용합니다.

--dtmi --model-id -m

Digital Twins 모델 ID. 예: dtmi:com:example:Room;2.

선택적 매개 변수

--def --definition

작업에서 모델 정의를 검색합니다.

허용되는 값: false, true
--resource-group -g

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

az dt model update

모델의 메타데이터를 업데이트합니다. 현재 모델은 커밋 해제만 가능합니다.

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

예제

대상 모델 커밋 해제

az dt model update -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --decommission

필수 매개 변수

--dt-name --dtn -n

인스턴스 이름 또는 호스트 이름을 Digital Twins. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값을 후속 상호 작용에 사용합니다.

--dtmi --model-id -m

Digital Twins 모델 ID. 예: dtmi:com:example:Room;2.

선택적 매개 변수

--decommission

대상 모델을 해제하려는 의도를 나타냅니다.

허용되는 값: false, true
--resource-group -g

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