Azure-docs: Issue in documentation regarding retrieving Device Twin over HTTP from device.

[MatthijsvdVeer]

This page lists the endpoints for devices, one of which is

Retrieve and update device twin properties. A device uses this endpoint to access its device twin's properties.

Below that section, it states the following:

These endpoints are exposed using MQTT v3.1.1, HTTPS 1.1, and AMQP 1.0 protocols. AMQP and MQTT are also available over WebSockets on port 443.

However, retrieving a device twin (from the device itself) is not supported on HTTP, it is supported on AMQP and MQTT.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 46282564-724c-bc0d-7c74-bb30ee8653aa
• Version Independent ID: c4f80f13-2a6a-2349-0a4a-882a873ef0ff
• Content: Understand Azure IoT Hub endpoints
• Content Source: articles/iot-hub/iot-hub-devguide-endpoints.md
• Service: iot-hub
• GitHub Login: @robinsh
• Microsoft Alias: robinsh

[SatishBoddu-MSFT]

@MatthijsvdVeer , Thanks for the feedback! We are currently investigating and will update you shortly.

[SatishBoddu-MSFT]

@MatthijsvdVeer ,I have assigned the issue to the content author @robinsh for further review and update the doc as appropriate.

[robinsh]

reassign: @JimacoMS3

[JimacoMS3]

Hi @MatthijsvdVeer ,

Thanks for your feedback. I'm checking with engineering about this. Have you actually validated that HTPPS is not supported by trying it?

Thanks,
Jimaco

[MatthijsvdVeer]

Yes, I tried it and using HTTPS and it comes up with an error message that says it only supports MQTT. But when you run the same code using MQTT or AMQP it works, I was using the C# SDK.
Important to note, I believe this might work with the service endpoint, but from the Device it definitely doesn't work. Let me know if you need more info, I can show you the error over Teams.

[JimacoMS3]

Thanks for the info! I think we're OK for the moment. I've asked our engineering team to look into it. I've noticed that in our documentation there are some topics where we say it's MQTT and AMQP only.

I think on the service-side, it should be only AMQP (and AMQP over WebSockets) for device/module twins.

Thanks again for your help. I'll update the thread with what I find out from engineering. It might take a few days for them to respond though.

[JimacoMS3]

@MatthijsvdVeer I've heard back from engineering. They've confirmed that reading and writing device twins and reading direct methods are not available over HTTPS from the device. I'll make the appropriate updates in the next couple of days. Thanks for pointing this out!

-Jimaco

[JimacoMS3]

Hi @MatthijsvdVeer Thanks again for your help. I've updated the topic to reflect that neither device twin (read/update) nor direct method reads support HTTPS on the device side. I'll leave this open for a day or two for you to comment if you feel that more needs to be done.

-Jimaco

[JimacoMS3]

please-close