Device distribution

Updated at:

IoT Platform distributes devices across regions, instances, or accounts. After you configure device distribution in the console, IoT Platform sends a notification to the device.

For the complete device distribution flow, see Device distribution.

Device distribution notifications

Downlink

  • Request topic: /sys/${productKey}/${deviceName}/thing/bootstrap/notify.
  • Response topic: /sys/${productKey}/${deviceName}/thing/bootstrap/notify_reply.

Alink request data format:

{
    "id": "123",
    "version": "1.0",
    "method": "thing.bootstrap.notify", 
    "params": {
      "cmd": 0
    }
}
Table 1. Request parameters
Parameter Type Description
id String The message ID. Must be a unique numeric string on the device. Valid values: 0 to 4294967295.
version String The protocol version. Set this parameter to 1.0.
method String The request method. Set this parameter to thing.bootstrap.notify.
params List The business request parameters.
cmd Integer Set this parameter to 0, which indicates that a device distribution occurred. The device must then request a new Bootstrap endpoint.

Alink response data format:

{
    "id": "456",
    "code":200,
    "data" : {}
}
Table 2. Response parameters
Parameter Type Description
id String The message ID. Must be a unique numeric string on the device. Valid values: 0 to 4294967295.
code Integer The result code. 200 indicates success. Other values indicate failure. For more information, see Error codes received by devices.
data Object The data returned by the device. This parameter is empty for device distribution notifications.