All Products
Search

This Product

    IoT Platform:Create a data destination

    Document Center

    IoT Platform:Create a data destination

    Last Updated:Jun 20, 2026

    The data forwarding feature in IoT Platform lets you route messages from device topics to other destinations for processing, filtering, storage, or analysis. These destinations include other topics, consumer groups subscribed to by an AMQP server, PolarDB for MySQL, ApsaraDB for RDS, Tablestore (Wide Column and Time Series), Time Series Database (TSDB), Lindorm, DataHub, ApsaraMQ for RocketMQ, Message Service (MNS), and Function Compute (FC). This feature links a data source (device messages) with a data destination by using a data forwarding parser and a parser script. This topic describes how to create a data destination.

    How it works

    image

    You can configure a data forwarding parser in IoT Platform to forward device messages (the data source) to a data destination, such as another topic, an AMQP server, or other Alibaba Cloud services. This process enables communication between devices, between devices and servers, and between devices and Alibaba Cloud services.

    Limitations

    • Each data destination supports only one data forwarding operation.

    • For a list of supported data destinations for data forwarding, see List of data destinations.

    • You can associate a single data forwarding parser with multiple data destinations for normal or exceptional data forwarding.

    • To forward data to other topics or cloud services, use the corresponding data forwarding functions in the parser script. For more information, see Functions to forward data to data destinations.

    Create a data destination

    1. Log on to the IoT Platform console.

    2. On the Overview page, find the instance that you want to manage and click the instance ID or instance name.

    3. In the left-side navigation pane, choose Message Forwarding > Data Forwarding.

    4. On the Data Forwarding page, click Go to New Version in the upper-right corner.

      Note

      If you have performed this operation before, you are automatically redirected to the new version of the Data Forwarding page.

    5. Click the Data destination tab, and then click Create data destination.

    6. In the Create data destination dialog box, configure the following parameters and click OK.

      Parameter

      Description

      Data destination name

      A custom name. The name must be 1 to 30 characters in length and can contain Chinese characters, Japanese characters, letters, digits, underscores (_), and hyphens (-). Each Chinese or Japanese character counts as two characters.

      Data destination description

      A custom description for the data destination.

      Operation

      Set the destination for data forwarding. For configuration examples, see the topics in Data forwarding examples.

    7. Optional: Repeat steps 5 and 6 to add multiple data destinations.

    Optional operations

    After you create a data destination, you can find it in the list on the Data destination tab and perform the following operations.

    Edit a data destination

    You can modify the name, description, and specific configurations of the data forwarding operation.

    1. In the Actions column of the target data destination, click Edit.

    2. In the Edit data destination dialog box, modify the settings.

    3. Click OK.

    Delete a data destination

    Warning

    Deleting a data destination that is in use by other services may cause them to become unavailable. Proceed with caution.

    1. In the Actions column of the target data destination, click Delete.

    2. Click OK.

    Next steps

    • Configure a parser.

    • On the Data destination tab, you can view the Status of a data destination to check if it is configured correctly or if data is being forwarded successfully. In the data destination list, check the Status column of the destination. A status of "Running" indicates that the destination is active. You can also click Delete in the Actions column to remove a data destination.

    API reference

    API

    Description

    CreateDestination

    Creates a data destination for a data source.

    UpdateDestination

    Updates the name, operation type, and description of a data destination.

    ListDestination

    Lists all created data destinations.

    GetDestination

    Retrieves the details of a specific data destination.

    DeleteDestination

    Deletes a data destination.

    FAQ