
# 创建规则引擎目的端
#### 功能介绍
在ROMA Connect创建规则引擎目的端。
#### URI
POST /v1/{project_id}/link/instances/{instance_id}/rules/destinations
表1参数说明 
| **名称**      | **类型** | **是否必填** | **描述**                 |
|:---|:---|:---|:---|
| project_id  | string | 是        | 租户每个区域对应的项目ID。         |
| instance_id | string | 是        | 租户使用ROMA Connect的实例ID。 |
   
#### 请求消息
**请求参数**
表2Body参数 
| **参数**          | **类型**  | **是否必填** | **说明**                                |
|:---|:---|:---|:---|
| rule_name       | string  | 是        | 系统中已经创建好的规则名称，如果规则不存在，默认创建该规则。        |
| mqs_topic       | string  | 是        | 转发目的端的MQS的Topic名称。                    |
| connect_address | string  | 是        | MQS Broker的连接地址。                      |
| destination     | string  | 是        | 消息转发的目的端的类型，目前只支持ROMA_MQS，KAFKA。      |
| mqs_sasl_ssl    | Boolean | 否        | 转发的目的端MQS是否开启SSL，这里需要确认MQS是否启用了SSL。   |
| user_name       | string  | 否        | MQS启用SSL时，需要传入MQS的用户名，未启用SSL不需要传入该参数。 |
| password        | string  | 否        | MQS启用SSL时，需要传入MQS的密码，未启用SSL不需要传入该参数。  |
   
**请求示例**
```
https://example.cloud.com/v1/80e2b******f4a398d6409a50932d917/link/instances/fb3b24ab-5d87-473d-9c57-fc6******6a1/rules/destination 
{ 
    "rule_name" : "rule01",
    "mqs_topic" : "mqs-topic01",
    "connect_address" : "192.168.x.x:9093,192.168.0.x:9093,192.168.0.x:9093",
    "destination" : "ROMA_MQS",
    "mqs_sasl_ssl" : false
}
```
#### 响应消息
**响应参数**
表3响应参数 
| **名称**      | **类型**  | **描述**     |
|:---|:---|:---|
| destKey     | string  | 规则引擎目的端。   |
| instanceId  | string  | 实例ID。      |
| ruleDestOid | integer | 规则引擎目的端ID。 |
| ruleOid     | integer | 规则ID。      |
| server      | string  | 连接地址。      |
| sslPassword | string  | SSL密码。     |
| sslUser     | string  | SSL用户。     |
| topicName   | string  | 主题名。       |
   
**响应示例**
```
{
    "ruleDestOid": 29,
    "ruleOid": 600071,
    "topicName": "topic02",
    "destKey": "ROMA_MQS",
    "instanceId": "8f3b9416-3f73-44e2-a32d-**********",
    "server": "192.168.0.x:9092,192.x.0.10:9092,192.168.0.x:9092",
    "sslUser": null,
    "sslPassword": "" 
}
```
