Manage data outbound rules

Create a data outbound rule

1. Log on to the ApsaraMQ for MQTT console. In the left-side navigation pane, click Instances.

2. In the top navigation bar, select the region where the instance that you want to manage resides. On the Instances page, click the instance name to go to the Instance Details page.

3. In the left-side navigation pane, click Rules. In the upper-left corner of the Rules page, click Create Rule.

4. On the Create Rule page, perform the following steps:

   1. In the Configure Basic Information step, configure the parameters and click Next. The following table describes the parameters.

      Parameter	Example	Description

      Parameter	Example	Description
      Rule ID	111111	The rule ID. The ID is a globally unique identifier of a rule. A rule ID can contain only letters, digits, hyphens (-), and underscores (_) and must contain at least one letter or digit. A rule ID must be 3 to 64 characters in length. If the value contains more than 64 characters, it is automatically truncated. A rule ID cannot be updated after the rule is created.
      Description	migrate from rocketmq	The rule description.
      Status	Enable	Specifies whether to enable the rule. Valid values: Enable Disable
      Rule Type	Data Outbound	The rule type. Valid values: Data Outbound: You can add a data outbound rule to export data from ApsaraMQ for MQTT to other Alibaba Cloud services. For more information, see Export data from ApsaraMQ for MQTT to other Alibaba Cloud services. Data Inbound: You can add a data inbound rule to import data from other Alibaba Cloud services to ApsaraMQ for MQTT. For more information, see Import data from other cloud services to ApsaraMQ for MQTT. Client Status Notification: You can export the status events of ApsaraMQ for MQTT clients to other Alibaba Cloud services. For more information, see Export status events of ApsaraMQ for MQTT clients.

   2. In the Configure Rule Source step, specify the data source and click Next.

      Parameter	Example	Description

      Parameter	Example	Description
      Topic	Topic A	The source topic from which you want to export data. Specify a topic in ApsaraMQ for MQTT. Important ApsaraMQ for MQTT supports multi-level topics, whereas ApsaraMQ for RocketMQ supports one-level topics. Therefore, a level-1 topic in ApsaraMQ for MQTT is mapped to a topic in ApsaraMQ for RocketMQ, and topics of other levels in ApsaraMQ for MQTT are mapped to message properties in ApsaraMQ for RocketMQ. For information about the mappings, see Message structure mappings between ApsaraMQ for MQTT and ApsaraMQ for RocketMQ.

   3. In the Configure Rule Destination step, specify the destination to which the data is forwarded and click Create.

      Parameter	Example	Description

      Parameter	Example	Description
      Destination Service Type	Message Queue for Apache RocketMQ	The cloud service to which the data of the source topic is forwarded. Note Only ApsaraMQ for RocketMQ is supported.
      Message Queue for Apache RocketMQ Instance	MQ_INST_13801563067*****_BbyOD2jQ	The ID of the ApsaraMQ for RocketMQ instance. Note You can select only an instance that resides in the same region as the ApsaraMQ for MQTT instance.
      Topic	Topic B	The topic on the ApsaraMQ for RocketMQ instance. In this example, the data of the source topic is forwarded to Topic B.

   After the data outbound rule is created, you can view the rule on the Rules page.

Modify a data outbound rule

1. In the rule list, find the rule that you want to edit. In the Actions column, choose More > Edit.

2. On the Edit Rule page, you can change all parameter values except the rule ID.

3. After you change the parameter values, click Save in the Configure Rule Destination step.

Delete a data outbound rule

1. In the rule list, find the rule that you want to delete. In the Actions column, choose More > Delete.

2. In the message that appears, click OK.

Enable a data outbound rule

1. In the rule list, find the rule that you want to enable. In the Actions column, choose More > Enable.

2. In the message that appears, click OK.

Disable a data outbound rule

1. In the rule list, find the rule that you want to disable. In the Actions column, choose More > Disable.

2. In the message that appears, click OK.

References

For information about how to push data from other Alibaba Cloud services to ApsaraMQ for MQTT clients, see Manage data inbound rules.