更新时间:2024-09-24 GMT+08:00

设备上报文件下载结果

功能描述

设备上报文件下载结果。

Topic

上行: $oc/devices/{device_id}/sys/events/up

参数说明

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

参数解释:

  • 网关设备上报时,子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id,否则将请求失败。
  • 直连设备上报时,object_device_id需与Topic中的device_id一致。
  • 若为空则默认该参数与Topic中的device_id一致。

services

可选

List<ServiceEvent>

参数解释:

事件服务列表。

ServiceEvent定义表

字段名

必选/可选

类型

参数描述

service_id

必选

String

参数解释:

系统字段。

取值范围:

固定为:"$file_manager"。

event_type

必选

String

参数解释:

系统字段。

取值范围:

固定为:"download_result_report"。

event_time

可选

String

参数解释:

事件时间。UTC时间,格式:yyyyMMdd'T'HHmmss'Z'。

设备上报数据不带该参数或参数格式错误时,则数据上报时间以平台时间为准。

paras

必选

Object

参数解释:

事件参数JSON对象。

paras参数列表

字段名

必选/可选

类型

参数描述

object_name

必选

String

参数解释:

OBS下载对象名称。

result_code

必选

Integer

参数解释:

设备下载文件状态。

取值范围:

结果码定义如下:

  • 0:下载成功
  • 1:下载失败

status_code

可选

Integer

参数解释:

文件下载到OBS返回的状态码。

status_description

可选

String

参数解释:

文件下载到OBS时状态的描述。

示例

Topic: $oc/devices/{device_id}/sys/events/up  
数据格式: 
{ 
    "object_device_id": "{object_device_id}", 
    "services": [{ 
        "service_id": "$file_manager", 
        "event_type": "download_result_report", 
        "event_time": "20151212T121212Z",
        "paras": { 
            "object_name": "c6b39067b0325db34663d3ef421a42f6_12345678_a.jpg",
            "result_code": 0,
            "status_code": 200,
            "status_description": "download success"
         } 
    }] 
}