Skip to content

Commit 09ff8ee

Browse files
committed
Metadata and links updated, minor Acrolinx updates to improve score
1 parent c9d05d8 commit 09ff8ee

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

articles/iot-hub/iot-hub-devguide-c2d-guidance.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: SoniaLopezBravo
66
ms.author: sonialopez
77
ms.service: azure-iot-hub
88
ms.topic: concept-article
9-
ms.date: 01/29/2018
9+
ms.date: 05/22/2025
1010
ms.custom: [amqp, mqtt, 'Role: Cloud Development', 'Role: IoT Device']
1111
---
1212

@@ -16,28 +16,28 @@ IoT Hub provides three options for device apps to expose functionality to a back
1616

1717
* [Direct methods](iot-hub-devguide-direct-methods.md) for communications that require immediate confirmation of the result. Direct methods are often used for interactive control of devices such as turning on a fan.
1818

19-
* [Twin's desired properties](iot-hub-devguide-device-twins.md) for long-running commands intended to put the device into a certain desired state. For example, set the telemetry send interval to 30 minutes.
19+
* [Device twin's desired properties](iot-hub-devguide-device-twins.md) for long-running commands intended to put the device into a certain desired state. For example, set the telemetry send interval to 30 minutes.
2020

2121
* [Cloud-to-device messages](iot-hub-devguide-messages-c2d.md) for one-way notifications to the device app.
2222

2323
To learn how [Azure IoT Plug and Play](../iot/overview-iot-plug-and-play.md) uses these options to control IoT Plug and Play devices, see [IoT Plug and Play service developer guide](../iot/concepts-developer-guide-service.md).
2424

2525
[!INCLUDE [iot-hub-basic](../../includes/iot-hub-basic-whole.md)]
2626

27-
Here is a detailed comparison of the various cloud-to-device communication options.
27+
Here's a detailed comparison of the various cloud-to-device communication options.
2828

29-
| Categories | Direct methods | Twin's desired properties | Cloud-to-device messages |
29+
| Categories | Direct methods | Device twin's desired properties | Cloud-to-device messages |
3030
| ---------- | -------------- | ------------------------- | ------------------------ |
3131
| Scenario | Commands that require immediate confirmation, such as turning on a fan. | Long-running commands intended to put the device into a certain desired state. For example, set the telemetry send interval to 30 minutes. | One-way notifications to the device app. |
3232
| Data flow | Two-way. The device app can respond to the method right away. The solution back end receives the outcome contextually to the request. | One-way. The device app receives a notification with the property change. | One-way. The device app receives the message
33-
| Durability | Disconnected devices are not contacted. The solution back end is notified that the device is not connected. | Property values are preserved in the device twin. Device will read it at next reconnection. Property values are retrievable with the [IoT Hub query language](iot-hub-devguide-query-language.md). | Messages can be retained by IoT Hub for up to 48 hours. |
33+
| Durability | Disconnected devices aren't contacted. The solution back end is notified that the device isn't connected. | Property values are preserved in the device twin. Device will read it at next reconnection. Property values are retrievable with the [IoT Hub query language](iot-hub-devguide-query-language.md). | IoT Hub can retain messages for up to 48 hours. |
3434
| Targets | Single device using **deviceId**, or multiple devices using [jobs](iot-hub-devguide-jobs.md). | Single device using **deviceId**, or multiple devices using [jobs](iot-hub-devguide-jobs.md). | Single device by **deviceId**. |
35-
| Size | Maximum direct method payload size is 128 KB for the request and 128 KB for the response. | Maximum desired properties size is 32 KB. | Up to 64 KB messages. |
36-
| Frequency | High. For more information, see [IoT Hub limits](iot-hub-devguide-quotas-throttling.md). | Medium. For more information, see [IoT Hub limits](iot-hub-devguide-quotas-throttling.md). | Low. For more information, see [IoT Hub limits](iot-hub-devguide-quotas-throttling.md). |
35+
| Size | Maximum direct method payload size is 128 KB for the request and 128 KB for the response. | Maximum desired properties size is 32 KB. | Up to 64-KB messages. |
36+
| Frequency | High. For more information, see [IoT Hub quotas and throttling](iot-hub-devguide-quotas-throttling.md). | Medium. For more information, see [IoT Hub quotas and throttling](iot-hub-devguide-quotas-throttling.md). | Low. For more information, see [IoT Hub quotas and throttling](iot-hub-devguide-quotas-throttling.md). |
3737
| Protocol | Available using MQTT or AMQP. | Available using MQTT or AMQP. | Available on all protocols. Device must poll when using HTTPS. |
3838

3939
Learn how to use direct methods, desired properties, and cloud-to-device messages in the following tutorials:
4040

4141
* [Quickstart: Control a device connected to an IoT hub](quickstart-control-device.md)
42-
* [Use desired properties to configure devices](tutorial-device-twins.md)
43-
* [Send cloud-to-device messages](c2d-messaging-node.md)
42+
* [Tutorial: Configure your devices from a back-end service](tutorial-device-twins.md)
43+
* [Send and receive cloud-to-device messages](c2d-messaging-node.md)

0 commit comments

Comments
 (0)