Create IoT Hub and Device to Cloud Consumer Group

Last updated: 19/06/2016

This template enables you to deploy an IoT Hub instance with device to cloud and cloud to device messaging configurations and a device to cloud consumer group.

This Azure Resource Manager (ARM) template was created by a member of the community and not by Microsoft. Each ARM template is licensed to you under a licence agreement by its owner, not Microsoft. Microsoft is not responsible for ARM templates provided and licensed by community members and does not screen for security, compatibility or performance. Community ARM templates are not supported under any Microsoft support programme or service, and are made available AS IS without warranty of any kind.

Parameters

Parameter Name Description
iotHubName Name of the IoT Hub instance to provision.
skuName One of the supported SKUs: F1, S1 or S2
capacityUnits Number of desired IoT Hub units. Restricted to 1 unit for F1. Can be set up to maximum number allowed for subscription.
d2cMessageRetentionInDaysPeriod Retention time in days for device-to-cloud messages.
d2cPartitionCount Number of desired partitions for device-to-cloud event ingestion.
c2dMessagesTTLAsIso8601 Default TTL in ISO_8601 format for cloud-to-device messages. The value can range from PT1M to PT2D (or any other format as per ISO_8601 standards for duration).
c2dMessagesMaxDeliveryCount Maximum delivery count for cloud-to-device messages per-device queues.
c2dFeebackMessagesTTLAsIso8601 TTL in ISO_8601 format for service-bound feedback messages. The value can range from PT1M to PT2D (or any other format as per ISO_8601 standards for duration).
c2dFeedbackMessagesMaxDeliveryCount Maximum delivery count for feedback queue.
c2dFeedbackMessagesLockDurationAsIso8601 Lock duration in ISO_8601 format for service-bound feedback messages. The value can range from PT5S to PT300S (or any other format as per ISO_8601 standards for duration).
d2cConsumerGroupName Name of device-to-cloud consumer group to provision on the IoT Hub instance.

Use the template

PowerShell
New-AzureRmResourceGroupDeployment -Name <deployment-name> -ResourceGroupName <resource-group-name> -TemplateUri https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/101-iothub-with-consumergroup-create/azuredeploy.json
Installing and configuring Azure PowerShell
Command line
azure config mode arm
azure group deployment create <my-resource-group> <my-deployment-name> --template-uri https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/101-iothub-with-consumergroup-create/azuredeploy.json
Installing and configuring the Azure cross-platform command-line interface