更新时间:2024-06-20 GMT+08:00
分享

创建外部推送通道

功能介绍

创建外部推送通道

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v2/{project_id}/push-channels

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。获取方法请参见 获取项目ID

最小长度:1

最大长度:64

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证

最小长度:0

最大长度:20000

表3 请求Body参数

参数

是否必选

参数类型

描述

channel_id

String

推送通道ID,非必填,若用户不填,则系统自动生成

最小长度:1

最大长度:64

channel

String

通道

name

String

推送通道名称

最小长度:1

最大长度:64

description

String

推送通道描述

最小长度:0

最大长度:255

endpoint

String

推送的地址

最小长度:1

最大长度:256

mqtt_channel_detail

CreateMqttChannelDetail object

MQTT通道配置详情

iotdb_channel_detail

CreateIoTDBChannelDetail object

MQTT通道配置详情

influxdb2_channel_detail

CreateInfluxDB2ChannelDetail object

MQTT通道配置详情

pulsar_channel_detail

CreatePulsarChannelDetail object

Pulsar通道配置详情

表4 CreateMqttChannelDetail

参数

是否必选

参数类型

描述

connection_info

MqttConnectionInfo object

创建外部推送通道请求结构体

push_info

MqttPushInfo object

创建MQTT推送信息

表5 MqttConnectionInfo

参数

是否必选

参数类型

描述

username

String

鉴权用户名

最小长度:1

最大长度:128

password

String

鉴权密码

最小长度:8

最大长度:128

trust_certs

Object

客户端信任证书列表

数组长度:0 - 5

verify_hostname

Boolean

客户端是否开启校验域名

缺省值:true

表6 MqttPushInfo

参数

是否必选

参数类型

描述

device_data

DeviceMqttPushInfo object

创建设备数据推送MQTT

表7 DeviceMqttPushInfo

参数

是否必选

参数类型

描述

topic

String

client推送的topic

最小长度:1

最大长度:256

format

String

数据格式转换类型

缺省值:iotda_1.0

最小长度:1

最大长度:32

qos

Integer

Mqtt的服务质量

最小值:0

最大值:2

缺省值:0

表8 CreateIoTDBChannelDetail

参数

是否必选

参数类型

描述

connection_info

IoTDBConnectionInfo object

创建外部推送通道请求结构体

push_info

IoTDBPushInfo object

创建IoTDB推送信息

表9 IoTDBConnectionInfo

参数

是否必选

参数类型

描述

username

String

鉴权用户名

最小长度:1

最大长度:128

password

String

鉴权密码

最小长度:8

最大长度:128

表10 IoTDBPushInfo

参数

是否必选

参数类型

描述

device_data

DeviceIoTDBPushInfo object

创建设备数据推送IoTDB

表11 DeviceIoTDBPushInfo

参数

是否必选

参数类型

描述

storage_group

String

数据存储的存储组

最小长度:1

最大长度:32

format

String

数据格式转换类型

缺省值:iotda_1.0

最小长度:1

最大长度:32

表12 CreateInfluxDB2ChannelDetail

参数

是否必选

参数类型

描述

connection_info

InfluxDB2ConnectionInfo object

创建外部推送通道请求结构体

push_info

InfluxDB2PushInfo object

创建IoTDB推送信息

表13 InfluxDB2ConnectionInfo

参数

是否必选

参数类型

描述

token

String

鉴权token

最小长度:1

最大长度:128

trust_certs

Object

客户端信任证书列表

数组长度:0 - 5

verify_hostname

Boolean

客户端是否开启校验域名

缺省值:true

表14 InfluxDB2PushInfo

参数

是否必选

参数类型

描述

device_data

DeviceInfluxDB2PushInfo object

创建设备数据推送MQTT

表15 DeviceInfluxDB2PushInfo

参数

是否必选

参数类型

描述

organization

String

一组用户的工作空间,一组用户下可以创建多个bucket

最小长度:1

最大长度:32

bucket

String

数据存储的地方,结合了数据库和存储周期的概念

最小长度:1

最大长度:32

format

String

数据格式转换类型

缺省值:iotda_1.0

最小长度:1

最大长度:32

表16 CreatePulsarChannelDetail

参数

是否必选

参数类型

描述

connection_info

PulsarConnectionInfo object

创建外部推送通道请求结构体

push_info

PulsarPushInfo object

创建Pulsar推送信息

表17 PulsarConnectionInfo

参数

是否必选

参数类型

描述

token

String

鉴权token

最小长度:1

最大长度:128

表18 PulsarPushInfo

参数

是否必选

参数类型

描述

device_data

DevicePulsarPushInfo object

创建设备数据推送Pulsar

表19 DevicePulsarPushInfo

参数

是否必选

参数类型

描述

topic

String

client推送的topic

最小长度:1

最大长度:256

响应参数

状态码: 201

表20 响应Body参数

参数

参数类型

描述

channel_id

String

推送通道ID

name

String

推送通道名称

channel

String

通道

description

String

推送通道描述

endpoint

String

推送的地址

mqtt_channel_detail

MqttChannelDetailDTO object

MQTT通道详情

iotdb_channel_detail

IoTDBChannelDetailDTO object

IoTDB通道详情

influxdb2_channel_detail

CreateInfluxDB2ChannelDetail object

MQTT通道配置详情

pulsar_channel_detail

PulsarChannelDetailDTO object

Pulsar通道详情

create_time

String

创建时间

update_time

String

更新时间

表21 MqttChannelDetailDTO

参数

参数类型

描述

connection_info

MqttConnectionInfoResp object

外部推送通道返回详情

push_info

MqttPushInfoResp object

MQTT推送信息详情

表22 MqttConnectionInfoResp

参数

参数类型

描述

username

String

鉴权用户名

trust_certs

Object

客户端信任证书列表

verify_hostname

Boolean

客户端是否开启校验域名

表23 MqttPushInfoResp

参数

参数类型

描述

device_data

DeviceMqttPushInfoDetail object

设备数据推送MQTT详情

表24 DeviceMqttPushInfoDetail

参数

参数类型

描述

topic

String

client推送的topic

最小长度:1

最大长度:256

format

String

数据格式转换类型

最小长度:1

最大长度:32

qos

Integer

MQTT的服务质量

最小值:0

最大值:2

表25 IoTDBChannelDetailDTO

参数

参数类型

描述

connection_info

IoTDBConnectionInfoResp object

创建外部推送通道请求结构体

push_info

IoTDBPushInfoResp object

IoTDB推送信息详情

表26 IoTDBConnectionInfoResp

参数

参数类型

描述

username

String

鉴权用户名

password

String

鉴权密码

表27 IoTDBPushInfoResp

参数

参数类型

描述

device_data

DeviceIoTDBPushInfoDetail object

创建设备数据推送IoTDB

表28 DeviceIoTDBPushInfoDetail

参数

参数类型

描述

storage_group

String

数据存储的存储组

最小长度:1

最大长度:32

format

String

数据格式转换类型

最小长度:1

最大长度:32

表29 CreateInfluxDB2ChannelDetail

参数

参数类型

描述

connection_info

InfluxDB2ConnectionInfo object

创建外部推送通道请求结构体

push_info

InfluxDB2PushInfo object

创建IoTDB推送信息

表30 InfluxDB2ConnectionInfo

参数

参数类型

描述

token

String

鉴权token

最小长度:1

最大长度:128

trust_certs

Object

客户端信任证书列表

数组长度:0 - 5

verify_hostname

Boolean

客户端是否开启校验域名

缺省值:true

表31 InfluxDB2PushInfo

参数

参数类型

描述

device_data

DeviceInfluxDB2PushInfo object

创建设备数据推送MQTT

表32 DeviceInfluxDB2PushInfo

参数

参数类型

描述

organization

String

一组用户的工作空间,一组用户下可以创建多个bucket

最小长度:1

最大长度:32

bucket

String

数据存储的地方,结合了数据库和存储周期的概念

最小长度:1

最大长度:32

format

String

数据格式转换类型

缺省值:iotda_1.0

最小长度:1

最大长度:32

表33 PulsarChannelDetailDTO

参数

参数类型

描述

connection_info

PulsarConnectionInfoResp object

外部推送通道返回详情

push_info

PulsarPushInfoResp object

Pulsar推送信息详情

表34 PulsarConnectionInfoResp

参数

参数类型

描述

token

String

鉴权token

最小长度:1

最大长度:128

表35 PulsarPushInfoResp

参数

参数类型

描述

device_data

DevicePulsarPushInfoDetail object

设备数据推送Pulsar详情

表36 DevicePulsarPushInfoDetail

参数

参数类型

描述

topic

String

client推送的topic

最小长度:1

最大长度:256

请求示例

POST https://{endpoint}/v2/{project_id}/push-channels

响应示例

状态码

状态码

描述

201

Created

400

BAD REQUEST

500

Internal Server Error

错误码

请参见错误码

相关文档