az dt endpoint

Note

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

Manage and configure Digital Twins instance endpoints.

Commands

Name	Description	Type	Status
az dt endpoint create	Add egress endpoints 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.	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 delete	Remove an endpoint from a Digital Twins instance.	Extension	GA
az dt endpoint list	List all egress endpoints configured on a Digital Twins instance.	Extension	GA
az dt endpoint show	Show details of an endpoint configured on a Digital Twins instance.	Extension	GA
az dt endpoint wait	Wait until an endpoint operation is done.	Extension	GA

az dt endpoint delete

Remove an endpoint from a Digital Twins instance.

az dt endpoint delete --dt-name --dtn
                      --en --endpoint-name
                      [--no-wait]
                      [--resource-group]
                      [--yes]

Examples

Remove an endpoint from an instance and block until the operation is complete.

az dt endpoint delete -n {instance_name} --endpoint-name {endpoint_name}

Remove an endpoint from an instance without confirmation or blocking.

az dt endpoint delete -n {instance_name} --endpoint-name {endpoint_name} -y --no-wait

Required Parameters

--dt-name --dtn -n

Digital Twins instance name.

--en --endpoint-name

Endpoint name.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

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

Property	Value
Default value:	False

--resource-group -g

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

--yes -y

Do not prompt for confirmation.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

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

Property	Value
Default value:	False

az dt endpoint list

List all egress endpoints configured on a Digital Twins instance.

az dt endpoint list --dt-name --dtn
                    [--resource-group]

Examples

List all egress endpoints configured on an instance.

az dt endpoint list -n {instance_name}

Required Parameters

--dt-name --dtn -n

Digital Twins instance name.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

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

Property	Value
Default value:	False

az dt endpoint show

Show details of an endpoint configured on a Digital Twins instance.

az dt endpoint show --dt-name --dtn
                    --en --endpoint-name
                    [--resource-group]

Examples

Show a desired endpoint by name on an instance.

az dt endpoint show -n {instance_name} --endpoint-name {endpoint_name}

Required Parameters

--dt-name --dtn -n

Digital Twins instance name.

--en --endpoint-name

Endpoint name.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

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

Property	Value
Default value:	False

az dt endpoint wait

Wait until an endpoint operation is done.

az dt endpoint wait --dt-name --dtn
                    --en --endpoint-name
                    [--created]
                    [--custom]
                    [--deleted]
                    [--exists]
                    [--interval]
                    [--resource-group]
                    [--timeout]

Examples

Wait until an endpoint for an instance is created.

az dt endpoint wait -n {instance_name} --endpoint-name {endpoint_name} --created

Wait until an existing endpoint is deleted from an instance.

az dt endpoint wait -n {instance_name} --endpoint-name {endpoint_name} --deleted

Wait until an existing endpoint's primaryConnectionString is null.

az dt endpoint wait -n {instance_name} --endpoint-name {endpoint_name} --custom "properties.primaryConnectionString==null"

Required Parameters

--dt-name --dtn -n

Digital Twins instance name.

--en --endpoint-name

Endpoint name.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Wait until created with 'provisioningState' at 'Succeeded'.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Property	Value
Parameter group:	Wait Condition Arguments

--deleted

Wait until deleted.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--exists

Wait until the resource exists.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--interval

Polling interval in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	30

--resource-group -g

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

--timeout

Maximum wait in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	3600

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

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

Property	Value
Default value:	False

Jaa

az dt endpoint

Commands

az dt endpoint delete

Examples

Required Parameters

Optional Parameters

az dt endpoint list

Examples

Required Parameters

Optional Parameters

az dt endpoint show

Examples

Required Parameters

Optional Parameters

az dt endpoint wait

Examples

Required Parameters

Optional Parameters

Palaute