Help Center> IoT Device Access> API Reference> 历史API> 应用侧API参考> 数据转发规则> 消息结构体说明
View PDF

消息结构体说明

转发设备上报的属性

根据定义的产品模型，上报设备属性至平台。结构体描述如下：
表1 属性上报规则转发结构体

参数名称

类型

描述

device_id

String

设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。

services

services[]

设备物模型的属性定义。
表2 services结构体

参数名称

类型

描述

service_id

String

设备的服务ID，在设备关联的产品模型中定义。

properties

ObjectNode[]

设备按照物模型上报的具体数据。

event_time

String

设备数据上报的时间，格式：yyyymmddThhmmssZ，例如20151212T121212Z。

属性上报转发结构体示例：

{
     "device_id":"String",
     "services":[
         {
             "service_id":"String",
             "properties":{
                 "property1":"String"
             },
             "event_time":"yyyyMMddTHHmmssZ"
         },
         {
             "service_id":"String",
             "properties":{
                 "property2":"String"
             },
             "event_time":"yyyyMMddTHHmmssZ"
         }
     ]
}

转发设备上报的消息

设备上报给平台的消息，不解析消息体中的数据具体含义，直接透传给华为云其他服务。

表3 消息上报规则转发结构体

参数名称

类型

描述

deviceId

String

设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。

productId

String

产品ID，用于唯一标识一个产品，在物联网平台创建产品后由平台分配获得。

topic

String

mqtt设备消息上报时的订阅主题topic

data

String

消息上报的具体内容，平台会将设备消息上报的结构体当成字符串放在data的value域。
消息上报转发结构体示例： 
 {
     "deviceId":"string",
     "data":"string",
     "productId":"string",
     "topic":"string"
 }

转发下行消息结果

应用服务器在物联网平台创建下行信息结果的规则后，当消息状态变更时，平台将消息结果推送给华为云其他服务。

表4 下行消息的结果转发结构体

参数名称

类型

描述

resource

String

订阅的资源名称，取值为device.message.status。

event

String

订阅的资源事件，取值为update。

notify_data

ObjectNode

设备的自定义字段列表。
表5 notify_data结构体

参数名称

类型

描述

message_id

String

消息的序列号，唯一标识一条消息。

name

String

消息名称。

device_id

String

设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。

status

String

设备消息状态，包含：DELIVERED,TIMEOUT,FAILED。

timestamp

String

消息更新时间,格式：yyyyMMdd'T'HHmmss'Z' UTC字符串，如：20151212T121212Z。

下行消息结果转发结构体示例：

 {
     "resource":"string",
     "event":"string",
     "notify_data":{
         "message_id":"string",
         "name":"string",
         "device_id":"string",
         "status":"string",
         "timestamp":"string"
    }
 }

转发设备状态

当直连设备的状态变更后，平台将变更状态的设备转发至华为云其他服务。

表6 设备状态变更转发结构体

参数名称

类型

描述

resource

String

订阅的资源名称，取值为device.status。

event

String

订阅的资源事件，取值为update。

notify_data

ObjectNode

设备的自定义字段列表。
表7 notify_data结构体

参数名称

类型

描述

app_id

String

资源空间ID

device_id

String

设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。

status

String

设备状态。

  • ONLINE：设备在线

  • OFFLINE：设备离线

  • ABNORMAL：设备异常

timestamp

String

设备状态变化时间,格式：yyyyMMdd'T'HHmmss'Z' UTC字符串，如：20151212T121212Z。

设备状态变更转发结构体示例：

{
    "resource":"string",
    "event":"string",
    "notify_data":{
        "device_id":"string",
        "app_id":"string",
        "status":"string",
        "timestamp":"string"
    }
}
父主题： 数据转发规则