文档首页/应用与数据集成平台 ROMA Connect/API参考/历史API/设备集成API（V1）/设备管理/创建设备自定义Topic
更新时间：2024-07-03 GMT+08:00
查看PDF
分享

创建设备自定义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。

请求消息

请求参数

表2 Body参数

参数

类型

是否必填

说明

product_name

string

是

系统中已经创建好的产品的产品名。

device_name

string

是

系统中已经创建好的设备的设备名。

topics

Array of topics objects

是

自定义Topic列表

表3 topics

参数

类型

是否必填

说明

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"
}
父主题：设备管理

相关文档