下载
中文
注册

上行消息接口格式

MindEdge OM向中心网管发送的消息格式定义如下:

{
    "header": {
        "msg_id": "584a2d50-11d1-4d60-83ce-f0cc48a45348",
        "parent_msg_id": "",
        "timestamp": 1550107087319,
        "sync": false,
        "resourceversion": ""
    },
    "route": {
        "source": "hardware",
        "group": "hub",
        "operation": "query",
        "resource": "websocket/profile_effect"
    },
    "content": {
    }
}

各个字段的定义如下:

属性

类型

解释

msg_id

string

对该消息的唯一标识,以便消息处理方进行去重、幂等性等操作,格式为UUID。

parent_msg_id

string

该消息的父消息,格式为UUID,可以此表示request/response关系。

  • 对于请求消息request,该字段为空。
  • 对于应答消息response,该字段为请求消息的msg_id。

timestamp

int

该消息的时间戳。

sync

bool

表示同步还是异步消息,取值为:

  • false:表示异步消息,不回应答。默认为false。
  • true:表示同步消息,要求边缘回应答。

resourceversion

string

空字符串或不传。

source

string

消息源,即发送消息的模块,从ESPManager上报的消息,统一填写hardware。

说明:

预留字段,取值可为“EdgeManager”“controller”

group

string

消息分类,参考消息分组定义。

说明:

预留字段,取值可为“resource”“twin”“hardware”“function”“user”

operation

string

消息操作类型,字符串格式。

说明:

预留字段,取值可为“insert”“update”“delete”“query”“restart”

resource

string

资源信息,字符串格式,具体请参见各个接口的具体定义。

content

json

具体的消息内容,由各个组件自行定义。

上行或下行消息中如果某个字段不存在,则表示该字段取其默认值。

消息分组定义如下:

方向

名称

解释

云侧处理软件

边侧处理组件

边-云,云-边

resource

资源的生命周期信息和元数据信息

EdgeManager,DeviceManager

MetaManager,Edged

边-云,云-边

hardware

与硬件设备管理平台交互信息

EdgeManager

EventBus

边-云,云-边

function

边缘侧函数的状态信息

FunctionManager

MetaManager,Edged

边-云,云-边

user

用户自己的数据

用户的应用或其他云服务

EventBus