
# 设备上报配置响应
#### 功能介绍
设备上报配置结果响应。创建远程配置任务时，可以配置超时时间（1-30天，不配置默认30天）。在超时时间内，平台每24小时向设备下发一次配置，直到设备上报配置响应。如果设备在超时时间内一直没有上报配置响应，则平台显示该设备配置任务超时失败。
#### 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 | **参数解释：** 系统字段。 **取值范围：** 固定为："$device_config"。           |
| event_type | 必选    | String | **参数解释：** 系统字段。 **取值范围：** 固定为："config_update_response"。 |
| event_time | 可选    | String | **参数解释：** 事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。 设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。                         |
| paras      | 必选    | Object | **参数解释：** 事件参数JSON对象。                                                                                                                                                                                         |
   
paras参数列表
| 字段名         | 必选/可选 | 类型      | 参数描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| result_code | 必选    | Integer | **参数解释：** 设备的配置结果。 **取值范围：** 结果码定义如下： - 0：处理成功。  - 其他整数：设备自定义异常。   |
| description | 可选    | String  | **参数解释：** 设备配置执行结果信息，可以返回具体配置失败原因。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   
#### 示例
```
Topic: $oc/devices/{device_id}/sys/events/up  
数据格式： 
{
    "object_device_id":"{object_device_id}",
    "services":[
        {
            "service_id":"$device_config",
            "event_type":"config_update_response",
            "event_time":"20151212T121212Z",
            "paras":{
                "result_code":0,
                "description":"update config success"
            }
        }
    ]
}
```
