다음을 통해 공유

az dt endpoint create

  • 참조

참고 항목

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

Digital Twins 인스턴스에 송신 엔드포인트를 추가합니다.

명령

Name Description 형식 상태
az dt endpoint create eventgrid

Digital Twins 인스턴스에 EventGrid 토픽 엔드포인트를 추가합니다. 미리 만든 리소스가 필요합니다.

 내선 번호 GA
az dt endpoint create eventhub

Digital Twins 인스턴스에 EventHub 엔드포인트를 추가합니다.

 내선 번호 GA
az dt endpoint create servicebus

Digital Twins 인스턴스에 ServiceBus 토픽 엔드포인트를 추가합니다.

 내선 번호 GA

az dt endpoint create eventgrid

Digital Twins 인스턴스에 EventGrid 토픽 엔드포인트를 추가합니다. 미리 만든 리소스가 필요합니다.

EventGrid 토픽 엔드포인트는 ID 기반 엔드포인트 통합을 지원하지 않습니다.

az dt endpoint create eventgrid --dt-name
                                --egt
                                --en
                                [--deadletter-sas-uri]
                                [--deadletter-uri]
                                [--egg]
                                [--egs]
                                [--no-wait]
                                [--resource-group]

예제

대상 인스턴스에 EventGrid 토픽 엔드포인트를 추가합니다.

az dt endpoint create eventgrid --endpoint-name {endpoint_name} --eventgrid-resource-group {eventgrid_resource_group} --eventgrid-topic {eventgrid_topic_name} -n {instance_name}

필수 매개 변수

--dt-name --dtn -n

Digital Twins 인스턴스 이름입니다.

--egt --eventgrid-topic

통합할 EventGrid 토픽의 이름입니다.

--en --endpoint-name

엔드포인트 이름입니다.

선택적 매개 변수

--deadletter-sas-uri --dsu

키 기반 인증을 위한 SAS 토큰이 있는 배달 못 한 편지 스토리지 컨테이너 URL입니다.

--deadletter-uri --du

ID 기반 인증에 대한 배달 못 한 편지 스토리지 컨테이너 URL입니다.

--egg --eventgrid-resource-group

EventGrid 토픽 리소스 그룹의 이름입니다. 제공되지 않으면 Digital Twin 인스턴스 리소스 그룹이 사용됩니다.

--egs --eventgrid-subscription

엔드포인트 리소스가 있는 구독의 이름 또는 ID입니다. 구독이 제공되지 않으면 기본 구독이 사용됩니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: 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 endpoint create eventhub

Digital Twins 인스턴스에 EventHub 엔드포인트를 추가합니다.

미리 만든 리소스가 필요합니다.

시스템 할당 ID 기반 엔드포인트 통합을 지원하려면 인스턴스에 시스템 할당 ID가 있어야 합니다. 인스턴스에는 사용자 할당 ID 기반 엔드포인트 통합을 지원하기 위해 연결된 사용자 할당 ID가 있어야 합니다.

az dt endpoint create eventhub --dt-name
                               --eh
                               --ehn
                               --en
                               [--auth-type {IdentityBased, KeyBased}]
                               [--deadletter-sas-uri]
                               [--deadletter-uri]
                               [--ehg]
                               [--ehp]
                               [--ehs]
                               [--mi-system-assigned {false, true}]
                               [--mi-user-assigned]
                               [--no-wait]
                               [--resource-group]

예제

키 기반 인증을 사용하여 대상 인스턴스에 EventHub 엔드포인트를 추가합니다.

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --eventhub-policy {eventhub_policy} -n {instance_name}

인증을 위해 시스템 할당 ID를 사용하여 대상 인스턴스에 EventHub 엔드포인트를 추가합니다.

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --mi-system-assigned -n {instance_name}

인증을 위해 사용자 할당 ID를 사용하여 대상 인스턴스에 EventHub 엔드포인트를 추가합니다.

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --mi-user-assigned {resource_id} -n {instance_name}

필수 매개 변수

--dt-name --dtn -n

Digital Twins 인스턴스 이름입니다.

--eh --eventhub

통합할 EventHub의 이름입니다.

--ehn --eventhub-namespace

EventHub 네임스페이스 식별자입니다.

--en --endpoint-name

엔드포인트 이름입니다.

선택적 매개 변수

--auth-type
사용되지 않음

'auth_type' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 'ID'를 사용합니다.

엔드포인트 인증 유형입니다.

허용되는 값: IdentityBased, KeyBased
기본값: KeyBased
--deadletter-sas-uri --dsu

키 기반 인증을 위한 SAS 토큰이 있는 배달 못 한 편지 스토리지 컨테이너 URL입니다.

--deadletter-uri --du

ID 기반 인증에 대한 배달 못 한 편지 스토리지 컨테이너 URL입니다.

--ehg --eventhub-resource-group

EventHub 리소스 그룹의 이름입니다. 제공되지 않으면 Digital Twin 인스턴스 리소스 그룹이 사용됩니다.

--ehp --eventhub-policy

엔드포인트 구성에 사용할 EventHub 정책입니다. --auth-type이 KeyBased인 경우 필요합니다.

--ehs --eventhub-subscription

엔드포인트 리소스가 있는 구독의 이름 또는 ID입니다. 구독이 제공되지 않으면 기본 구독이 사용됩니다.

--mi-system-assigned --system

엔드포인트 인증에 시스템 할당 관리 ID를 사용합니다.

허용되는 값: false, true
--mi-user-assigned --user

엔드포인트 인증에 사용자 할당 관리 ID를 사용합니다. ID 리소스 ID를 허용합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: 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 endpoint create servicebus

Digital Twins 인스턴스에 ServiceBus 토픽 엔드포인트를 추가합니다.

미리 만든 리소스가 필요합니다.

시스템 할당 ID 기반 엔드포인트 통합을 지원하려면 인스턴스에 시스템 할당 ID가 있어야 합니다. 인스턴스에는 사용자 할당 ID 기반 엔드포인트 통합을 지원하기 위해 연결된 사용자 할당 ID가 있어야 합니다.

az dt endpoint create servicebus --dt-name
                                 --en
                                 --sbn
                                 --sbt
                                 [--auth-type {IdentityBased, KeyBased}]
                                 [--deadletter-sas-uri]
                                 [--deadletter-uri]
                                 [--mi-system-assigned {false, true}]
                                 [--mi-user-assigned]
                                 [--no-wait]
                                 [--resource-group]
                                 [--sbg]
                                 [--sbp]
                                 [--sbs]

예제

키 기반 인증을 사용하여 대상 인스턴스에 ServiceBus 토픽 엔드포인트를 추가합니다.

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --servicebus-policy {servicebus_policy} -n {instance_name}

인증에 시스템 할당 ID를 사용하여 대상 인스턴스에 ServiceBus 토픽 엔드포인트를 추가합니다.

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --mi-system-assigned -n {instance_name}

인증을 위해 사용자 할당 ID를 사용하여 대상 인스턴스에 ServiceBus 토픽 엔드포인트를 추가합니다.

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --mi-user-assigned {resource_id} -n {instance_name}

필수 매개 변수

--dt-name --dtn -n

Digital Twins 인스턴스 이름입니다.

--en --endpoint-name

엔드포인트 이름입니다.

--sbn --servicebus-namespace

ServiceBus 네임스페이스 식별자입니다.

--sbt --servicebus-topic

통합할 ServiceBus 토픽의 이름입니다.

선택적 매개 변수

--auth-type
사용되지 않음

'auth_type' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 'ID'를 사용합니다.

엔드포인트 인증 유형입니다.

허용되는 값: IdentityBased, KeyBased
기본값: KeyBased
--deadletter-sas-uri --dsu

키 기반 인증을 위한 SAS 토큰이 있는 배달 못 한 편지 스토리지 컨테이너 URL입니다.

--deadletter-uri --du

ID 기반 인증에 대한 배달 못 한 편지 스토리지 컨테이너 URL입니다.

--mi-system-assigned --system

엔드포인트 인증에 시스템 할당 관리 ID를 사용합니다.

허용되는 값: false, true
--mi-user-assigned --user

엔드포인트 인증에 사용자 할당 관리 ID를 사용합니다. ID 리소스 ID를 허용합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: False
--resource-group -g

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

--sbg --servicebus-resource-group

ServiceBus 리소스 그룹의 이름입니다. 제공되지 않으면 Digital Twin 인스턴스 리소스 그룹이 사용됩니다.

--sbp --servicebus-policy

엔드포인트 구성에 사용할 ServiceBus 토픽 정책입니다. --auth-type이 KeyBased인 경우 필요합니다.

--sbs --servicebus-subscription

엔드포인트 리소스가 있는 구독의 이름 또는 ID입니다. 구독이 제공되지 않으면 기본 구독이 사용됩니다.

전역 매개 변수
--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를 사용합니다.