Azure Functions中能否从Service Bus消息获取发送端设备deviceId？

算力阿峰

2026-7-29

可以在Azure Function中从Service Bus消息获取设备ID

完全可以获取到发送消息的设备ID。当IoT Hub将消息路由到Service Bus队列时，会自动将设备相关的元数据（包括设备ID）添加到消息的系统属性中，无需额外配置即可通过ServiceBusReceivedMessage读取。

获取设备ID的具体方式

读取默认系统属性
IoT Hub默认会将设备ID存入消息的系统属性iothub-connection-device-id中，直接通过SystemProperties集合读取即可：

public void Run([ServiceBusTrigger("your-queue-name", Connection = "ServiceBusConnection")] ServiceBusReceivedMessage message)
{
    if (message.SystemProperties.TryGetValue("iothub-connection-device-id", out var deviceIdValue))
    {
        string deviceId = deviceIdValue.ToString();
        // 后续业务逻辑处理
    }
}

自定义属性映射（可选）
如果需要将设备ID放到消息的自定义属性中，可在IoT Hub的路由规则里配置属性映射，将系统变量$connectionDeviceId映射到自定义属性（比如deviceId），之后就能从ApplicationProperties中读取：

public void Run([ServiceBusTrigger("your-queue-name", Connection = "ServiceBusConnection")] ServiceBusReceivedMessage message)
{
    if (message.ApplicationProperties.TryGetValue("deviceId", out var deviceIdValue))
    {
        string deviceId = deviceIdValue.ToString();
        // 后续业务逻辑处理
    }
}