다음을 통해 공유

az iot ops schema registry

  • 미리 보기
  • 참조

참고 항목

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

명령 그룹 'iot ops 스키마'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

스키마 레지스트리 관리.

스키마 레지스트리는 스키마를 관리하기 위한 중앙 집중식 리포지토리입니다. 스키마 레지스트리를 사용하면 에지와 클라우드 모두에서 스키마를 생성하고 검색할 수 있습니다. 스키마 정의에 대한 단일 진리 소스를 제공하여 시스템 간 일관성과 호환성을 보장합니다.

명령

Name Description 형식 상태
az iot ops schema registry create

스키마 레지스트리를 만듭니다.

 내선 번호 프리뷰
az iot ops schema registry delete

대상 스키마 레지스트리를 삭제합니다.

 내선 번호 프리뷰
az iot ops schema registry list

리소스 그룹 또는 구독의 스키마 레지스트리를 나열합니다.

 내선 번호 프리뷰
az iot ops schema registry show

스키마 레지스트리의 세부 정보를 표시합니다.

 내선 번호 프리뷰

az iot ops schema registry create

미리 보기

명령 그룹 'iot ops 스키마'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

스키마 레지스트리를 만듭니다.

이 작업은 시스템 관리 ID를 사용하도록 설정된 스키마 레지스트리를 만듭니다.

그런 다음, 기본적으로 스토리지 계정 컨테이너 범위에 대해 기본 제공 "Storage Blob 데이터 기여자" 역할을 시스템 ID에 할당합니다. 필요한 경우 대신 사용할 --custom-role-id를 통해 사용자 지정 역할을 제공할 수 있습니다.

표시된 스토리지 계정 컨테이너가 없으면 기본 설정으로 만들어집니다.

이 작업은 등록되지 않은 경우 Microsoft.DeviceRegistry 리소스 공급자도 등록합니다.

az iot ops schema registry create --name
                                  --registry-namespace
                                  --resource-group
                                  --sa-resource-id
                                  [--custom-role-id]
                                  [--desc]
                                  [--display-name]
                                  [--location]
                                  [--sa-container]
                                  [--tags]

예제

최소 입력을 사용하여 'myregistry'라는 스키마 레지스트리를 만듭니다.

az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID

추가 사용자 지정을 사용하여 westus2 지역에 'myregistry'라는 스키마 레지스트리를 만듭니다.

az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID --sa-container myschemacontainer -l westus2 --desc 'Contoso factory X1 schemas' --display-name 'Contoso X1' --tags env=prod

필수 매개 변수

--name -n

스키마 레지스트리 이름입니다.

--registry-namespace --rn

스키마 레지스트리 네임스페이스입니다. 테넌트 내에서 스키마 레지스트리를 고유하게 식별합니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--sa-resource-id

스키마 레지스트리와 함께 사용할 스토리지 계정 리소스 ID입니다.

선택적 매개 변수

--custom-role-id

/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleId}형식의 정규화된 역할 정의 ID입니다.

--desc

스키마 레지스트리에 대한 설명입니다.

--display-name

스키마 레지스트리의 표시 이름입니다.

--location -l

스키마 레지스트리를 만들 지역입니다. 위치가 제공되지 않으면 리소스 그룹 위치가 사용됩니다.

--sa-container

스키마가 저장될 스토리지 계정 컨테이너 이름입니다.

Default value: schemas
--tags

스키마 레지스트리 태그입니다. a=b c=d 형식의 키-값 쌍의 속성 모음입니다. --tags ""를 사용하여 모든 태그를 제거합니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az iot ops schema registry delete

미리 보기

명령 그룹 'iot ops 스키마'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

대상 스키마 레지스트리를 삭제합니다.

az iot ops schema registry delete --name
                                  [--resource-group]
                                  [--yes {false, true}]

예제

스키마 레지스트리 'myregistry'를 삭제합니다.

az iot ops schema registry delete -n myregistry -g myresourcegroup

필수 매개 변수

--name -n

스키마 레지스트리 이름입니다.

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--yes -y

프롬프트 없이 [y]es를 확인합니다. CI 및 자동화 시나리오에 유용합니다.

허용되는 값: false, true
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az iot ops schema registry list

미리 보기

명령 그룹 'iot ops 스키마'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

리소스 그룹 또는 구독의 스키마 레지스트리를 나열합니다.

az iot ops schema registry list [--resource-group]

예제

리소스 그룹 'myresourcegroup'의 스키마 레지스터를 나열합니다.

az iot ops schema registry list -g myresourcegroup

특정 태그에 대한 기본 구독 필터링에 스키마 등록을 나열합니다.

az iot ops schema registry list --query "[?tags.env == 'prod']"

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az iot ops schema registry show

미리 보기

명령 그룹 'iot ops 스키마'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

스키마 레지스트리의 세부 정보를 표시합니다.

az iot ops schema registry show --name
                                --resource-group

예제

대상 스키마 레지스트리 'myregistry'의 세부 정보를 표시합니다.

az iot ops schema registry show --name myregistry -g myresourcegroup

필수 매개 변수

--name -n

스키마 레지스트리 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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