# 设备孪生变更
设备孪生更新文档，当孪生变化时，反映孪生变化前、变化后的区别。
#### Topic
$hw/events/device/{device_id}/twin/update/document
| 参数        | 类型     | 说明     |
|:---|:---|:---|
| device_id | String | 终端设备ID |
   
#### 使用方式
使用MQTT客户端**订阅**该Topic。
#### 参数说明
| 参数        | 类型     | 说明                                                                                                                             |
|:---|:---|:---|
| event_id  | String | 事件ID                                                                                                                           |
| timestamp | Int64  | 事件发生事件戳                                                                                                                        |
| twin      | Object | 设备孪生变更信息集合，每个孪生以key/value形式存在。value中包含变化前last、变更后current的孪生信息，孪生信息中包含是否可选、孪生metadata包含类型信息、孪生期望状态包含期望值和更新时间、孪生真实状态包含真实值和更新时间等。 |
   
#### 示例
终端设备绑定到边缘节点时可收到如下消息。
```
$hw/events/device/{device_id}/twin/update/document
{
     "event_id":"",
     "timestamp":1557314742122,
     "twin":{
         "state":{
             "last":null,
             "current":{
                 "expected":{
                     "value":"running",
                     "metadata":{
                         "timestamp":1557314742122
                     }
                 },
                 "optional":true,
                 "metadata":{
                     "type":"string"
                 }
             }
         }
     }
 }
```