如何使用Azure IoT C# SDK正确更新IoT Hub设备的Cloud Property

问题原因 #

你通过设备端SDK的UpdateReportedPropertiesAsync方法更新标记为Cloud类型的属性时，属性被放入_unmodeleddata的核心原因是：

• DTDL中标记为[@type: "Cloud"]的属性属于云端专属管理属性，设备端没有权限直接修改或上报这类属性。
• 设备端UpdateReportedPropertiesAsync仅用于上报设备自身维护的reported properties，而Cloud属性不在设备的可上报模型范围内，因此被归类到未建模数据中。

正确解决方案 #

Cloud类型属性只能通过IoT Hub服务端SDK进行修改，以下是C#实现步骤：

1. 安装服务端SDK包 #

在项目中安装Azure.IoT.Hub.Service NuGet包：

Install-Package Azure.IoT.Hub.Service

2. 编写更新代码 #

使用DigitalTwinClient来更新设备数字孪生中的Cloud属性：

using Azure;
using Azure.DigitalTwins.Core;
using Azure.Identity;
using System.Threading;

// 初始化DigitalTwinClient
var iotHubEndpoint = "https://<你的IoT Hub名称>.azure-devices.net";
var credential = new DefaultAzureCredential();
var digitalTwinClient = new DigitalTwinClient(new Uri(iotHubEndpoint), credential);

// 构建属性更新操作
var patchDocument = new JsonPatchDocument();
// 替换Cloud属性值，路径对应DTDL中的属性名
patchDocument.AppendReplace("/DeviceSerialNumber", "dsn1i90NEW");

// 执行更新
var deviceId = "<你的设备ID>";
try
{
    await digitalTwinClient.UpdateDigitalTwinAsync(deviceId, patchDocument, CancellationToken.None);
}
catch (RequestFailedException ex)
{
    // 处理异常，比如权限不足、设备不存在等
    Console.WriteLine($"更新失败: {ex.Message}");
}

关键注意事项 #

• 确保执行更新的身份拥有IoT Hub的RegistryWrite或更高权限（比如IoT Hub Contributor）。
• Cloud属性仅支持云端修改，设备端只能读取该属性的值，无法通过设备端SDK上报修改。

内容的提问来源于stack exchange，提问作者Mike Lenart