# 网关更新子设备状态
#### 功能介绍
网关更新子设备状态，更新结果通过网关更新子设备状态响应接口通知网关设备。网关与子设备关系，请查看[网关与子设备](https://support.huaweicloud.com/usermanual-iothub/iot_01_0052.html)。
- 接口tps限制为直连设备并发建链的1.5倍。即为单个实例每秒最大建立请求连接数量为100\*购买单元数量 \*1.5。
- 该接口1次调用的tps为1\*上报子设备的数量。
 
#### Topic
上行: $oc/devices/{device_id}/sys/events/up
#### 参数说明
| 字段名              | 必选/可选 | 类型                   | 参数描述                                                                                                                                                |
|:---|:---|:---|:---|
| object_device_id | 可选    | String               | **参数解释：** 该参数目前暂未实装使用，无需填写。 |
| services         | 可选    | List\<EventService\> | **参数解释：** 事件服务列表。          |
   
EventService定义表
| 字段名        | 必选/可选 | 类型     | 参数描述                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| service_id | 必选    | String | **参数解释：** 系统字段，固定为："$sub_device_manager"。                                                                                                                                                                  |
| event_type | 必选    | String | **参数解释：** 系统字段，固定为："sub_device_update_status"。                                                                                                                                                          |
| event_time | 可选    | String | **参数解释：** 事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。 设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。 |
| event_id   | 可选    | String | **参数解释：** 事件请求Id，唯一标识这次事件请求。如果不携带该参数，该参数由物联网平台自动生成，生成规则为数字、字母、中划线组成的36位随机字符串。                                                                                                                            |
| paras      | 必选    | Object | **参数解释：** 事件参数JSON对象。                                                                                                                                                                                     |
   
paras参数列表
| 字段名             | 必选/可选 | 类型                   | 参数描述                                                                                                                                                  |
|:---|:---|:---|:---|
| device_statuses | 必选    | List\<DeviceStatus\> | **参数解释：** 设备状态列表，列表大小1\~100。 |
   
DeviceStatus定义表:
| 字段名       | 必选/可选 | 类型     | 参数描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| device_id | 必选    | String | **参数解释：** 子设备ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| status    | 必选    | String | **参数解释：** 子设备状态。 **取值范围：** - OFFLINE：设备离线。  - ONLINE：设备上线。   |
   
#### 示例
```
Topic: $oc/devices/{device_id}/sys/events/up
数据格式：
```
```
{
        "object_device_id": "{object_device_id}",
"services": [{
"service_id": "$sub_device_manager",
"event_type": "sub_device_update_status",
"event_time": "20151212T121212Z",
"paras": {
"device_statuses": [{
"device_id": "bf40f0c4-4022-41c6-a201-c5133122054a",
"status": "ONLINE"
},
{
"device_id": "4459c0f7-10bb-4718-9b07-7a82c2d508a5",
"status": "ONLINE"
}
]
}
}]
}
```