# 订阅LINK设备的通知消息
#### 概述
ROMA Connect提供设备变更通知服务，当订阅的设备状态发生变化，如设备上线、下线、删除等，ROMA Connect会发送消息到对应的消息集成Topic，方便实时获取设备最新状态信息。
#### 前提条件
已有可用的Topic，且Topic与设备在同一应用下，用于接收消息，否则请提前[创建Topic](https://support.huaweicloud.com/usermanual-roma/mqs-ug-190429002.html)。
#### 订阅设备通知消息
1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)，在左侧导航栏选择"资源管理"，在实例页面单击实例，进入实例控制台。
2. 在左侧的导航栏选择"设备集成 LINK \> 订阅管理"。
3. 在订阅管理页面中，选择要接收通知消息的Topic所属的集成应用。
4. 在要订阅的消息通知类型下，选择要接收通知消息单独Topic，然后启用通知。
   - 通知的启用与关闭，最长的生效时间为30秒。
   
   - 设备变更包含以下操作时，触发消息通知。
     - 设备类型变更（例如普通设备修改为网关子设备）。
     
     - 设备名称变更。
     
     - 设备状态变更。
     
     - 设备描述变更。
      
   
   - 通知消息示例请参见[设备通知报文示例]。
    
 
 #### 设备通知报文示例
以普通设备为例介绍订阅管理中MQS各报文示例。
- 消息属性
  ```
  {
  "deviceIdentifier":"iottest2", // 设备标识
  "eventTime":"1588843914884",   // 消息时间
  "gatewayIdentifier":"null",  // 网关设备标识
  "deviceId":"D114VKx7a",        // 设备ID
  "gatewayId":"null",           // 网关设备ID
  "TAGS":"null"                  // 消息标签
  }
  ```
  ![](https://support.huaweicloud.com/usermanual-roma/public_sys-resources/note_3.0-zh-cn.png)
  - 普通设备/网关设备时，gatewayId和gatewayIdentifier的值设置为null。
  
  - 网关子设备时，gatewayId和gatewayIdentifier分别为其网关设备的deviceId和deviceIdentifier。
    
 
- 消息内容
  1. 设备添加
     ```
     {
     'deviceType':'Default',        // 设备类型
     'instanceOid':'40',             // 实例Oid
     'manufacturerName':'iotcompro1',// 厂商名称
     'productOid':'1',        // 产品Oid
     'manufacturerId':'iotcompro1',  // 厂商ID
     'remark':'',                // 设备描述
     'deviceId':'D114VKx7a',         // 设备ID
     'deviceName':'iottest2',// 设备名称
     'productName':'iotcompro1',// 产品名称
     'notifyType':'deviceAdded',// 消息类型
     'deviceIdentifier':'iottest2',// 设备标识
     'deviceOid':'14',        // 设备Oid
     'createdBy':'admin',        // 创建者
     'eventTime':'1588843914884',// 消息时间
     'model':'iotcompro1',        // 产品模型
     'productType':'0',        // 产品类型 1-网关产品 0-普通产品
     'status':'0',                // 设备状态 0-启用 1-禁用
     'parentDeviceOid':'null'// 父设备Oid
     }
     ```
     
  
  2. 设备删除
     ```
     {
     'notifyType':'deviceDeleted',// 消息类型
     'deviceIdentifier':'iottest2',// 设备标识
     'eventTime':'1588843914884',// 消息时间
     'deviceId':'D114VKx7a'        // 设备ID
     }
     ```
     
  
  3. 设备上线
     ```
     {
         'notifyType':'deviceOnline',    // 消息类型-设备上线
         'deviceIdentifier':'iottest2',  // 设备标识
         'eventTime':'1588843914884',    // 消息时间
         'deviceId':'D114VKx7a'          // 设备ID
     }
     ```
     
  
  4. 设备下线
     ```
     {
         'notifyType':'deviceOffline',   // 消息类型
         'deviceIdentifier':'iottest2',  // 设备标识
         'eventTime':'1588843914884',    // 消息时间
         'deviceId':'D114VKx7a'          // 设备ID
     }
     ```
     
  
  5. 设备类型变更
     ```
     {
     'instanceOid':'40',              // 实例Oid
     'productOid':'1',            // 产品Oid
     'remark':'',                 // 设备描述
     'deviceId':'D114VKx7a',      // 设备ID
     'deviceName':'iottest1', // 设备名称
     'notifyType':'deviceChange', // 消息类型
     'deviceIdentifier':'iottest1',   // 设备标识
     'deviceOid':'1',         // 设备Oid
     'createdBy':'admin',         // 创建者
     'eventTime':'1588843914884', // 消息时间
     'status':'0',                 // 设备状态 0-启用 1-禁用
     'parentDeviceOid':'null' // 父设备Oid
     }
     ```