Skip to content

Commit 34c52a7

Browse files
authored
Merge pull request #88352 from JimacoMS3/iot-hub-scaling-topic-updates
Added import/export ops to REST table and fixed text for units
2 parents 7a2a81c + a77be07 commit 34c52a7

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

articles/iot-hub/iot-hub-scaling.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Each IoT Hub tier is available in three sizes, based around how much data throug
2727

2828
The standard tier of IoT Hub enables all features, and is required for any IoT solutions that want to make use of the bi-directional communication capabilities. The basic tier enables a subset of the features and is intended for IoT solutions that only need uni-directional communication from devices to the cloud. Both tiers offer the same security and authentication features.
2929

30-
Only one type of [edition](https://azure.microsoft.com/pricing/details/iot-hub/) within a tier can be chosen per IoT Hub. For example, you can create an IoT Hub with multiple units of S1, but not with a mix of units from different editions, such as S1 and B3, or S1 and S2.
30+
Only one type of [edition](https://azure.microsoft.com/pricing/details/iot-hub/) within a tier can be chosen per IoT Hub. For example, you can create an IoT Hub with multiple units of S1, but not with a mix of units from different editions, such as S1 and S2.
3131

3232
| Capability | Basic tier | Free/Standard tier |
3333
| ---------- | ---------- | ------------- |
@@ -80,6 +80,10 @@ The difference in supported capabilities between the basic and standard tiers of
8080
| Send module event | AMQP and MQTT only | AMQP and MQTT only |
8181
| [Update file upload status](https://docs.microsoft.com/rest/api/iothub/device/updatefileuploadstatus) | Yes | Yes |
8282
| [Bulk device operation](https://docs.microsoft.com/rest/api/iothub/service/bulkcreateorupdatedevices) | Yes, except for IoT Edge capabilities | Yes |
83+
| [Cancel import export job](https://docs.microsoft.com/rest/api/iothub/service/cancelimportexportjob) | Yes | Yes |
84+
| [Create import export job](https://docs.microsoft.com/rest/api/iothub/service/createimportexportjob) | Yes | Yes |
85+
| [Get import export job](https://docs.microsoft.com/rest/api/iothub/service/getimportexportjob) | Yes | Yes |
86+
| [Get import export jobs](https://docs.microsoft.com/rest/api/iothub/service/getimportexportjobs) | Yes | Yes |
8387
| [Purge command queue](https://docs.microsoft.com/rest/api/iothub/service/purgecommandqueue) | | Yes |
8488
| [Get device twin](https://docs.microsoft.com/rest/api/iothub/service/gettwin) | | Yes |
8589
| [Get module twin](https://docs.microsoft.com/rest/api/iothub/service/getmoduletwin) | | Yes |
@@ -101,17 +105,17 @@ The best way to size an IoT Hub solution is to evaluate the traffic on a per-uni
101105
* Cloud-to-device messages
102106
* Identity registry operations
103107

104-
Traffic is measured on a per-unit basis, not per hub. A level 1 or 2 IoT Hub instance can have as many as 200 units associated with it. A level 3 IoT Hub instance can have up to 10 units. Once you create your IoT hub you can change the number of units or move between the 1, 2, and 3 sizes within a specific tier without interrupting your existing operations. For more information, see [How to upgrade your IoT Hub](iot-hub-upgrade.md).
108+
Traffic is measured for your IoT hub on a per-unit basis. When you create an IoT hub, you choose its tier and edition, and set the number of units available. You can purchase up to 200 units for the B1, B2, S1, or S2 edition, or up to 10 units for the B3 or S3 edition. After your IoT hub is created, you can change the number of units available within its edition, upgrade or downgrade between editions within its tier (B1 to B2), or upgrade from the basic to the standard tier (B1 to S1) without interrupting your existing operations. For more information, see [How to upgrade your IoT hub](iot-hub-upgrade.md).
105109

106110
As an example of each tier's traffic capabilities, device-to-cloud messages follow these sustained throughput guidelines:
107111

108-
| Tier | Sustained throughput | Sustained send rate |
112+
| Tier edition | Sustained throughput | Sustained send rate |
109113
| --- | --- | --- |
110114
| B1, S1 |Up to 1111 KB/minute per unit<br/>(1.5 GB/day/unit) |Average of 278 messages/minute per unit<br/>(400,000 messages/day per unit) |
111115
| B2, S2 |Up to 16 MB/minute per unit<br/>(22.8 GB/day/unit) |Average of 4,167 messages/minute per unit<br/>(6 million messages/day per unit) |
112116
| B3, S3 |Up to 814 MB/minute per unit<br/>(1144.4 GB/day/unit) |Average of 208,333 messages/minute per unit<br/>(300 million messages/day per unit) |
113117

114-
In addition to this throughput information, see [IoT Hub quotas and throttles](iot-hub-devguide-quotas-throttling.md) and design your solution accordingly.
118+
Device-to-cloud throughput is only one of the metrics you need to consider when designing an IoT solution. For more comprehensive information, see [IoT Hub quotas and throttles](iot-hub-devguide-quotas-throttling.md).
115119

116120
### Identity registry operation throughput
117121

@@ -121,7 +125,7 @@ For specific burst performance numbers, see [IoT Hub quotas and throttles](iot-h
121125

122126
## Auto-scale
123127

124-
If you are approaching the allowed message limit on your IoT Hub, you can use these [steps to automatically scale](https://azure.microsoft.com/resources/samples/iot-hub-dotnet-autoscale/) to increment an IoT Hub unit in the same IoT Hub tier.
128+
If you are approaching the allowed message limit on your IoT hub, you can use these [steps to automatically scale](https://azure.microsoft.com/resources/samples/iot-hub-dotnet-autoscale/) to increment an IoT Hub unit in the same IoT Hub tier.
125129

126130
## Next steps
127131

0 commit comments

Comments
 (0)