az dt model

참고 항목

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

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

명령

Name	Description	형식	상태
az dt model create	하나 이상의 모델을 업로드합니다.	내선 번호	GA
az dt model delete	모델 삭제. 모델을 참조하는 다른 모델이 없는 경우에만 모델을 삭제할 수 있습니다.	내선 번호	GA
az dt model delete-all	Digital Twins 인스턴스 내의 모든 모델을 삭제합니다.	내선 번호	GA
az dt model list	모델 메타데이터, 정의 및 종속성을 나열합니다.	내선 번호	GA
az dt model show	대상 모델 또는 모델 정의를 검색합니다.	내선 번호	GA
az dt model update	모델의 메타데이터를 업데이트합니다. 현재 모델은 커밋 해제만 가능합니다.	내선 번호	GA

az dt model create

하나 이상의 모델을 업로드합니다.

--models는 인라인 json 또는 파일 경로일 수 있습니다. 입력 모델 집합(온톨로지)의 크기는 DT 인스턴스가 저장할 수 있는 최대 모델 수로 제한됩니다(기본값은 10000개 모델).

az dt model create --dt-name
                   [--failure-policy {None, Rollback}]
                   [--fd]
                   [--max-models-per-batch]
                   [--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 인스턴스 이름 또는 호스트 이름입니다. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값이 후속 상호 작용에 사용됩니다.

선택적 매개 변수

--failure-policy --fp

모델 일괄 처리를 처리하는 동안 오류가 발생할 때 오류 정책을 나타냅니다. '롤백' 모드에서는 이전 일괄 처리에서 만든 모든 모델이 한 번에 하나씩 삭제됩니다. '없음'으로 선택하면 이전 일괄 처리에서 만든 모델은 DT 인스턴스에서 삭제되지 않습니다.

허용되는 값: None, Rollback

기본값: Rollback

--fd --from-directory

디렉터리 JSON 모델 파일은 구문 분석됩니다. 참고: 디렉터리에 250개 이하의 모델이 포함된 경우 모델이 원자성으로 생성되므로 오류가 발생하는 경우 모델을 만들지 않습니다. 입력 모델 집합은 디렉터리에 250개 이상의 모델(API 제한)이 있는 경우 일괄 처리로 청크 분할되고 만들어집니다. 일괄 처리를 처리하는 동안 오류가 발생하면 --failure-policy 매개 변수에 의해 동작이 결정됩니다.

--max-models-per-batch --mmpb

실험적

250개 이상의 모델을 만들 때 일괄 처리당 최대 모델 크기입니다. DTDLParser 오류를 방지하려면 이 수를 줄입니다.

기본값: 30

--models

모델 JSON에 대한 인라인 모델 JSON 또는 파일 경로입니다. 참고: 모델 JSON에 250개 이하의 모델이 포함되어 있으면 모델이 원자성으로 생성되므로 오류가 발생하는 경우 모델을 만들지 않습니다. 입력 모델 집합은 모델 JSON에 250개 이상의 모델(API 제한)이 있는 경우 일괄 처리로 청크 분할되고 만들어집니다. 일괄 처리를 처리하는 동안 오류가 발생하면 --failure-policy 매개 변수에 의해 동작이 결정됩니다.

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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

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>을 사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

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

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

기본값: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az dt model list

모델 메타데이터, 정의 및 종속성을 나열합니다.

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

기본값: False

--dependencies-for

종속성을 검색할 모델 집합입니다. 생략하면 모든 모델이 검색됩니다. 형식은 공백으로 구분된 목록입니다.

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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

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

기본값: False

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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

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>을 사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.