Help Center/ ROMA Connect/ Developer Guide/ Developer Guide for Device Integration/ MQTT Topic Specifications/ Updating the Gateway Subdevice Status
Updated on 2025-07-21 GMT+08:00
View PDF

Updating the Gateway Subdevice Status

Topic

Topic

/v1/devices/{gatewayId}/topo/update

Publisher

Edge device

Subscriber

IoT platform

Parameter Description

Field

Mandatory/Optional

Type

Description

mid

Mandatory

Integer

Command ID.

deviceStatuses

Mandatory

List<DeviceStatus>

Device status list. The list contains 1 to 100 records.

deviceStatus struct description

Field

Mandatory/Optional

Type

Description

deviceId

Mandatory

String

Unique device ID generated by the IoT platform, which corresponds to the device client ID.

status

Mandatory

String

Subdevice status. The options are as follows:

  • OFFLINE
  • ONLINE

Example

{
       "deviceStatuses": [{
              "deviceId": "D59eGSxy",
              "status": "ONLINE"
       }],
       "mid": 9
}