az dt model

Note

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

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

명령

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

az dt model create

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

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

az dt model create --dt-name --dtn
                   [--failure-policy --fp {None, Rollback}]
                   [--fd --from-directory]
                   [--max-models-per-batch --mmpb]
                   [--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 인스턴스에서 삭제되지 않습니다.

속성	값
매개 변수 그룹:	Models Input Arguments
Default value:	Rollback
허용되는 값:	None, Rollback

--fd --from-directory

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

속성	값
매개 변수 그룹:	Models Input Arguments

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

실험적

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

속성	값
매개 변수 그룹:	Models Input Arguments
Default value:	30

--models

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

속성	값
매개 변수 그룹:	Models Input Arguments

--resource-group -g

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

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az dt model delete

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

az dt model delete --dt-name --dtn
                   --dtmi --model-id
                   [--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

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az dt model delete-all

Digital Twins 인스턴스 내의 모든 모델을 삭제합니다.

트윈 구성은 영향을 받지 않지만 모델 정의 없이 손상될 수 있습니다.

az dt model delete-all --dt-name --dtn
                       [--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

확인 메시지를 표시하지 않습니다.

속성	값
Default value:	False

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az dt model list

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

az dt model list --dt-name --dtn
                 [--def --definition {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

이 작업은 모델 정의를 검색합니다.

속성	값
Default value:	False
허용되는 값:	false, true

--dependencies-for

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

--resource-group -g

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

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az dt model show

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

az dt model show --dt-name --dtn
                 --dtmi --model-id
                 [--def --definition {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

이 작업은 모델 정의를 검색합니다.

속성	값
Default value:	False
허용되는 값:	false, true

--resource-group -g

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

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az dt model update

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

az dt model update --dt-name --dtn
                   --dtmi --model-id
                   [--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

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False