更新时间:2023-11-29 GMT+08:00
分享

创建设备自定义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"
}
分享:

    相关文档

    相关产品