# 创建设备自定义Topic
#### 功能介绍
在ROMA Connect创建一个Topic。
#### URI
POST /v1/{project_id}/link/instances/{instance_id}/topics
表1参数说明 
| **名称**      | **类型** | **是否必填** | **描述**                 |
|:---|:---|:---|:---|
| project_id  | string | 是        | 租户每个区域对应的项目ID。         |
| instance_id | string | 是        | 租户使用ROMA Connect的实例ID。 |
   
#### 请求消息
**请求参数**
表2Body参数 
| **参数**       | **类型**                                                      | **是否必填** | **说明**           |
|:---|:---|:---|:---|
| product_name | string                                                      | 是        | 系统中已经创建好的产品的产品名。 |
| device_name  | string                                                      | 是        | 系统中已经创建好的设备的设备名。 |
| topics       | Array of [topics] objects | 是        | 自定义Topic列表       |
   
 表3topics 
| **参数**     | **类型** | **是否必填** | **说明**                                   |
|:---|:---|:---|:---|
| topic_name | string | 是        | 自定义Topic的名称，支持英文大小写、数字、下划线和中划线，不超过64个字符。 |
| topic_perm | string | 是        | 自定义Topic的权限，只支持pub或sub两种权限。              |
| remark     | string | 否        | 描述信息，不能超过200个字符。                         |
   
**请求示例**
```
https://example.cloud.com/v1/80e2b******f4a398d6409a50932d917/link/instances/fb3b24ab-5d87-473d-9c57-fc6******6a1/topics 
{ 
    "product_name" : "product01",
    "device_name" : "device01",
    "topics" : [{"topic_name" : "alarm",
    "topic_perm" : "sub",
    "remark" : "alarm topic"}]
}
```
#### 响应消息
**响应参数**
表4响应参数 
| **名称**     | **类型**  | **描述**                                                                                                                                                                                                                                    |
|:---|:---|:---|
| remark     | string  | 描述信息，不能超过200个字符。                                                                                                                                                                                                                          |
| topic_id   | integer | Topic的ID。 - -1：系统Topic。  - 大于0：自定义Topic。   |
| topic_name | string  | Topic名。                                                                                                                                                                                                                                   |
| topic_perm | string  | Topic的权限，只支持pub或sub两种权限。                                                                                                                                                                                                                  |
   
**响应示例**
```
{
    "remark": "alarm topic ",
    "topic_id": null,
    "topic_name": "alarm",
    "topic_perm": "pub"
}
```