az dt endpoint create

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.37.0 or higher). The extension will automatically install the first time you run an az dt endpoint create command. Learn more about extensions.

Add egress endpoints to a Digital Twins instance.

Commands

Name	Description	Type	Status
az dt endpoint create eventgrid	Adds an EventGrid Topic endpoint to a Digital Twins instance. Requires pre-created resource.	Extension	GA
az dt endpoint create eventhub	Adds an EventHub endpoint to a Digital Twins instance.	Extension	GA
az dt endpoint create servicebus	Adds a ServiceBus Topic endpoint to a Digital Twins instance.	Extension	GA

az dt endpoint create eventgrid

Adds an EventGrid Topic endpoint to a Digital Twins instance. Requires pre-created resource.

EventGrid topic endpoints do not support identity based endpoint integration.

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

Examples

Adds an EventGrid Topic endpoint to a target instance.

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

Required Parameters

--dt-name --dtn -n

Digital Twins instance name.

--egt --eventgrid-topic

Name of EventGrid Topic to integrate with.

--en --endpoint-name

Endpoint name.

Optional Parameters

--deadletter-sas-uri --dsu

Dead-letter storage container URL with SAS token for Key based authentication.

--deadletter-uri --du

Dead-letter storage container URL for Identity based authentication.

--egg --eventgrid-resource-group

Name of EventGrid Topic resource group. If not provided, the Digital Twin instance resource group will be used.

--egs --eventgrid-subscription

Name or id of subscription where the endpoint resource exists. If no subscription is provided the default subscription is used.

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--resource-group -g

Digital Twins instance resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az dt endpoint create eventhub

Adds an EventHub endpoint to a Digital Twins instance.

Requires pre-created resource.

The instance must have a system-assigned identity to support system-assigned identity based endpoint integration. The instance must have the user-assigned identity associated to support user-assigned identity based endpoint integration.

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]

Examples

Adds an EventHub endpoint to a target instance using Key based auth.

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}

Adds an EventHub endpoint to a target instance using the system-assigned identity for authentication.

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}

Adds an EventHub endpoint to a target instance using an user-assigned identity for authentication.

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}

Required Parameters

--dt-name --dtn -n

Digital Twins instance name.

--eh --eventhub

Name of EventHub to integrate with.

--ehn --eventhub-namespace

EventHub Namespace identifier.

--en --endpoint-name

Endpoint name.

Optional Parameters

--auth-type

Deprecated

Argument 'auth_type' has been deprecated and will be removed in a future release. Use 'identity' instead.

Endpoint authentication type.

accepted values: IdentityBased, KeyBased

default value: KeyBased

--deadletter-sas-uri --dsu

Dead-letter storage container URL with SAS token for Key based authentication.

--deadletter-uri --du

Dead-letter storage container URL for Identity based authentication.

--ehg --eventhub-resource-group

Name of EventHub resource group. If not provided, the Digital Twin instance resource group will be used.

--ehp --eventhub-policy

EventHub policy to use for endpoint configuration. Required when --auth-type is KeyBased.

--ehs --eventhub-subscription

Name or id of subscription where the endpoint resource exists. If no subscription is provided the default subscription is used.

--mi-system-assigned --system

Use the system-assigned managed identity for endpoint authentication.

accepted values: false, true

--mi-user-assigned --user

Use an user-assigned managed identity for endpoint authentication. Accepts the identity resource id.

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--resource-group -g

Digital Twins instance resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az dt endpoint create servicebus

Adds a ServiceBus Topic endpoint to a Digital Twins instance.

Requires pre-created resource.

The instance must have a system-assigned identity to support system-assigned identity based endpoint integration. The instance must have the user-assigned identity associated to support user-assigned identity based endpoint integration.

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]

Examples

Adds a ServiceBus Topic endpoint to a target instance using Key based auth.

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}

Adds a ServiceBus Topic endpoint to a target instance using the system-assigned identity for authentication.

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}

Adds a ServiceBus Topic endpoint to a target instance using an user-assigned identity for authentication.

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}

Required Parameters

--dt-name --dtn -n

Digital Twins instance name.

--en --endpoint-name

Endpoint name.

--sbn --servicebus-namespace

ServiceBus Namespace identifier.

--sbt --servicebus-topic

Name of ServiceBus Topic to integrate with.

Optional Parameters

--auth-type

Deprecated

Argument 'auth_type' has been deprecated and will be removed in a future release. Use 'identity' instead.

Endpoint authentication type.

accepted values: IdentityBased, KeyBased

default value: KeyBased

--deadletter-sas-uri --dsu

Dead-letter storage container URL with SAS token for Key based authentication.

--deadletter-uri --du

Dead-letter storage container URL for Identity based authentication.

--mi-system-assigned --system

Use the system-assigned managed identity for endpoint authentication.

accepted values: false, true

--mi-user-assigned --user

Use an user-assigned managed identity for endpoint authentication. Accepts the identity resource id.

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--resource-group -g

Digital Twins instance resource group. You can configure the default group using az configure --defaults group=<name>.

--sbg --servicebus-resource-group

Name of ServiceBus resource group. If not provided, the Digital Twin instance resource group will be used.

--sbp --servicebus-policy

ServiceBus Topic policy to use for endpoint configuration. Required when --auth-type is KeyBased.

--sbs --servicebus-subscription

Name or id of subscription where the endpoint resource exists. If no subscription is provided the default subscription is used.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.