You can use the rules engine of IoT Platform to forward data from specified topics to other topics or other Alibaba Cloud services. This article describes how to add topics to a data source.

Background information

When you configure a data forwarding parser, you must associate the parser with topics from which data is forwarded. You can add a maximum of 1,000 topics to each data source.

You can use the topic(n) function in a script to obtain the topic from which data is forwarded. For more information, see Functions supported by the data forwarding feature.

Create a data source

  1. Log on to the IoT Platform console.
  2. In the left-side navigation pane, choose Rules > Data Forwarding.
  3. On the Data Forwarding page, click Go to New Version in the upper-right corner to go to the new version.
    Note If you have performed this step, the Data Forwarding page of the new version appears after you choose Rules > Data Forwarding.
  4. Click the Data Source tab. On this tab, click Create Data Source.
  5. Enter a data source name and description, and then click OK.
    The name must be 1 to 30 characters in length, and can contain letters, digits, underscores (_), and hyphens (-).
    The Data Source Details page appears. You can click Edit in the upper-right corner to modify the name and description of the data source. Data Source Details
  6. On the Data Source Details page, click Add Topic. In the dialog box that appears, select the topic that you want to process, and then click OK.
    Valid values:
    • Custom: Custom topics support wildcard characters, including plus signs (+) and number signs (#).
      • All equipment (+): indicates all devices of the specified product.
      • /user/#: indicates all topics of the specified device.

      For more information, see Custom topics.

    • Device Status Change Notification: specifies the topic that is used to receive notifications when the status of a device changes between online and offline.
    • TSL Data Reporting: specifies the topic that is used to receive device properties and events.

      You can select one of the following topics:

      • thing/event/property/post: This topic is used to receive device properties.
      • thing/event/${tsl.identityId}/post: This topic is used to receive device events.
      • thing/downlink/reply/message: This topic is used to receive messages that a device sends to respond to IoT Platform commands.
    • Device Changes Throughout Lifecycle: specifies the topic that is used to receive notifications when a device is created, deleted, disabled, or enabled.
    • Sub-Device Data Report Detected by Gateway: specifies the topic that is used to receive the information about a new sub-device when a gateway detects the sub-device.
    • Device Topological Relation Changes: specifies the topic that is used to receive notifications when topological relationships between sub-devices and the gateway are created and deleted.
    • Device tag change: specifies the topic that is used to receive notifications when a device tag is changed.
    • TSL Historical Data Reporting: specifies the topic that is used to receive historical device properties and events.
    • Device status notification: specifies the topic that is used to receive over-the-air (OTA) update status. You can select one of the following topics:
      • ota/upgrade: This topic is used to receive update results.
      • ota/progress/post: This topic is used to receive update progress.
    • Submit a module version number: specifies the topic that is used to receive notifications when the version number of an OTA module for a device is changed.
    • Batch status notification: specifies the topic to which IoT Platform sends notifications when the status of OTA update batches changes.
    • Job Event: specifies the topic that is used to receive the status of device jobs.
    • Edge Plug and Play Message: specifies the topic that is used to receive pass-through data from Link IoT Edge.
  7. Optional:Perform the previous step to add multiple topics to the data source.
    You can delete the added topics on the Data Source Details page based on your business requirements. Topics
  8. Optional:Perform Step 5 to Step 8 to create multiple data sources.

What to do next

Create a data destination