Share via


az iot hub routing-endpoint

This command group has been deprecated and will be removed in a future release. Use 'IoT Extension (azure-iot) message-endpoint command group (az iot hub message-endpoint)' instead.

Manage custom endpoints of an IoT hub.

Commands

Name Description Type Status
az iot hub routing-endpoint create

Add an endpoint to your IoT Hub.

Core Deprecated
az iot hub routing-endpoint delete

Delete all or mentioned endpoint for your IoT Hub.

Core Deprecated
az iot hub routing-endpoint list

Get information on all the endpoints for your IoT Hub.

Core Deprecated
az iot hub routing-endpoint show

Get information on mentioned endpoint for your IoT Hub.

Core Deprecated

az iot hub routing-endpoint create

Deprecated

This command is implicitly deprecated because command group 'iot hub routing-endpoint' is deprecated and will be removed in a future release. Use 'IoT Extension (azure-iot) message-endpoint command group (az iot hub message-endpoint)' instead.

Add an endpoint to your IoT Hub.

Create a new custom endpoint in your IoT Hub.

az iot hub routing-endpoint create --endpoint-name
                                   --endpoint-resource-group
                                   --endpoint-subscription-id
                                   --endpoint-type {azurestoragecontainer, eventhub, servicebusqueue, servicebustopic}
                                   --hub-name
                                   [--auth-type {identityBased, keyBased}]
                                   [--batch-frequency]
                                   [--chunk-size]
                                   [--connection-string]
                                   [--container]
                                   [--encoding {avro, json}]
                                   [--endpoint-uri]
                                   [--entity-path]
                                   [--ff]
                                   [--identity]
                                   [--resource-group]

Examples

Add a new endpoint "E2" of type EventHub to "MyIotHub" IoT Hub.

az iot hub routing-endpoint create --resource-group MyResourceGroup --hub-name MyIotHub --endpoint-name E2 --endpoint-type eventhub --endpoint-resource-group {ResourceGroup} --endpoint-subscription-id {SubscriptionId} --connection-string {ConnectionString}

Add a new endpoint "S1" of type AzureStorageContainer to the "MyIotHub" IoT Hub within the endpoint resource group "MyEndpointResourceGroup".

az iot hub routing-endpoint create --resource-group MyResourceGroup --hub-name MyIotHub \
--endpoint-name S1 --endpoint-type azurestoragecontainer --endpoint-resource-group MyEndpointResourceGroup \
--endpoint-subscription-id {SubscriptionId} --connection-string {ConnectionString} \
--container-name {ContainerName} --batch-frequency 100 --chunk-size 100 \
--ff {iothub}-{partition}-{YYYY}-{MM}-{DD}-{HH}-{mm}

Add a new identity-based EventHub endpoint named "EventHubIdentity" and authenticate using a user-assigned managed identity

az iot hub routing-endpoint create --resource-group MyResourceGroup --hub-name MyIotHub --endpoint-name EventHubIdentity --endpoint-type eventhub --endpoint-resource-group {ResourceGroup} --endpoint-subscription-id {SubscriptionId} --auth-type identityBased --identity {userIdentityResourceId} --endpoint-uri {EventHubEndpointUri} --entity-path {EntityPath}

Required Parameters

--endpoint-name --name -n

Name of the Routing Endpoint.

--endpoint-resource-group --erg -r

Resource group of the Endpoint resoure.

--endpoint-subscription-id -s

SubscriptionId of the Endpoint resource.

--endpoint-type --type -t

Type of the Routing Endpoint.

Accepted values: azurestoragecontainer, eventhub, servicebusqueue, servicebustopic
--hub-name

IoT Hub name.

Optional Parameters

--auth-type

Authentication type for the endpoint. The default is keyBased.

Accepted values: identityBased, keyBased
--batch-frequency -b

Request batch frequency in seconds. The maximum amount of time that can elapse before data is written to a blob, between 60 and 720 seconds.

Default value: 300
--chunk-size -w

Request chunk size in megabytes(MB). The maximum size of blobs, between 10 and 500 MB.

Default value: 300
--connection-string -c

Connection string of the Routing Endpoint.

--container --container-name

Name of the storage container.

--encoding

Encoding format for the container. The default is AVRO. Note that this field is applicable only for blob container endpoints.

Accepted values: avro, json
--endpoint-uri

The uri of the endpoint resource.

--entity-path

The entity path of the endpoint resource.

--ff --file-name-format

File name format for the blob. The file name format must contain {iothub}, {partition}, {YYYY}, {MM}, {DD}, {HH} and {mm} fields. All parameters are mandatory but can be reordered with or without delimiters.

Default value: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}
--identity

Use a system-assigned or user-assigned managed identity for endpoint authentication. Use "[system]" to refer to the system-assigned identity or a resource ID to refer to a user-assigned identity. If you use --auth-type without this parameter, system-assigned managed identity is assumed.

--resource-group -g

Name of 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 iot hub routing-endpoint delete

Deprecated

This command is implicitly deprecated because command group 'iot hub routing-endpoint' is deprecated and will be removed in a future release. Use 'IoT Extension (azure-iot) message-endpoint command group (az iot hub message-endpoint)' instead.

Delete all or mentioned endpoint for your IoT Hub.

Delete an endpoint for your IoT Hub. We recommend that you delete any routes to the endpoint, before deleting the endpoint.

az iot hub routing-endpoint delete [--endpoint-name]
                                   [--endpoint-type {azurestoragecontainer, eventhub, servicebusqueue, servicebustopic}]
                                   [--hub-name]
                                   [--ids]
                                   [--resource-group]
                                   [--subscription]

Examples

Delete endpoint "E2" from "MyIotHub" IoT Hub.

az iot hub routing-endpoint delete --resource-group MyResourceGroup --hub-name MyIotHub --endpoint-name E2

Delete all the endpoints of type "EventHub" from "MyIotHub" IoT Hub.

az iot hub routing-endpoint delete --resource-group MyResourceGroup --hub-name MyIotHub --endpoint-type eventhub

Delete all the endpoints from "MyIotHub" IoT Hub.

az iot hub routing-endpoint delete --resource-group MyResourceGroup --hub-name MyIotHub

Optional Parameters

--endpoint-name --name -n

Name of the Routing Endpoint.

--endpoint-type --type -t

Type of the Routing Endpoint.

Accepted values: azurestoragecontainer, eventhub, servicebusqueue, servicebustopic
--hub-name

IoT Hub name.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

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

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 iot hub routing-endpoint list

Deprecated

This command is implicitly deprecated because command group 'iot hub routing-endpoint' is deprecated and will be removed in a future release. Use 'IoT Extension (azure-iot) message-endpoint command group (az iot hub message-endpoint)' instead.

Get information on all the endpoints for your IoT Hub.

Get information on all endpoints in your IoT Hub. You can also specify which endpoint type you want to get informaiton on.

az iot hub routing-endpoint list [--endpoint-type {azurestoragecontainer, eventhub, servicebusqueue, servicebustopic}]
                                 [--hub-name]
                                 [--ids]
                                 [--resource-group]
                                 [--subscription]

Examples

Get all the endpoints from "MyIotHub" IoT Hub.

az iot hub routing-endpoint list -g MyResourceGroup --hub-name MyIotHub

Get all the endpoints of type "EventHub" from "MyIotHub" IoT Hub.

az iot hub routing-endpoint list -g MyResourceGroup --hub-name MyIotHub --endpoint-type eventhub

Optional Parameters

--endpoint-type --type -t

Type of the Routing Endpoint.

Accepted values: azurestoragecontainer, eventhub, servicebusqueue, servicebustopic
--hub-name

IoT Hub name.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

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

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 iot hub routing-endpoint show

Deprecated

This command is implicitly deprecated because command group 'iot hub routing-endpoint' is deprecated and will be removed in a future release. Use 'IoT Extension (azure-iot) message-endpoint command group (az iot hub message-endpoint)' instead.

Get information on mentioned endpoint for your IoT Hub.

Get information on a specific endpoint in your IoT Hub.

az iot hub routing-endpoint show --endpoint-name
                                 [--hub-name]
                                 [--ids]
                                 [--resource-group]
                                 [--subscription]

Examples

Get an endpoint information from "MyIotHub" IoT Hub.

az iot hub routing-endpoint show --resource-group MyResourceGroup --hub-name MyIotHub \
--endpoint-name {endpointName}

Required Parameters

--endpoint-name --name -n

Name of the Routing Endpoint.

Optional Parameters

--hub-name

IoT Hub name.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

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

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.