文档首页/ IoT数据分析 IoTA/ API参考/ API列表/ 数据源配置/ 创建数据源
更新时间：2022-07-13 GMT+08:00
查看PDF
分享

创建数据源

功能介绍

创建数据源

调试

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

URI

POST /v1/{project_id}/datasources

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

projectid

最小长度：1

最大长度：128

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

租户Token

最小长度：1

最大长度：65535
表3 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

数据源名称

最大长度：128

type

是

String

数据源类型, 包括：IOTDA、API、DIS

content

是

ContentDetailReq object

数据源详细配置内容
表4 ContentDetailReq

参数

是否必选

参数类型

描述

iotda_content

否

IotdaContentReq object

IoTDA数据源详细配置内容

dis_content

否

DisContentReq object

DIS数据源详细配置内容

api_content

否

ApiContentReq object

api数据源配置内容
表5 IotdaContentReq

参数

是否必选

参数类型

描述

iotda_instance_id

是

String

IoTDA实例Id

最小长度：1

最大长度：256

rules

是

Array of IotdaContentRuleReq objects

在IoTDA实例中要配置转发规则推送数据的资源空间和产品列表
表6 IotdaContentRuleReq

参数

是否必选

参数类型

描述

app_id

是

String

IoTDA中的资源空间Id

最小长度：1

最大长度：256

products

是

Array of strings

IoTDA中某资源空间Id下的产品列表
表7 DisContentReq

参数

是否必选

参数类型

描述

project_id

是

String

项目id

最小长度：1

最大长度：128

stream_name

是

String

通道名称

最小长度：1

最大长度：256

ak

是

String

租户的AK

最小长度：1

最大长度：256

sk

是

String

租户的SK

最小长度：1

最大长度：256
表8 ApiContentReq

参数

是否必选

参数类型

描述

name

是

String

api数据源名称

最小长度：1

最大长度：128

响应参数

状态码： 201

表9 响应Body参数

参数

参数类型

描述

id

String

数据源id

最小长度：1

最大长度：256

name

String

数据源名称

最大长度：128

type

String

数据源类型, 包括：IOTDA、API、DIS。数据源不支持修改类型。

content

ContentDetailRsp object

数据源详细配置内容

created_time

String

创建时间，格式为：yyyy-MM-dd'T'HH:mm:ss'Z'

最小长度：1

最大长度：64

modified_time

String

修改时间，格式为：yyyy-MM-dd'T'HH:mm:ss'Z'

最小长度：1

最大长度：64
表10 ContentDetailRsp

参数

参数类型

描述

iotda_content

IotdaContentRsp object

IoTDA数据源详细配置内容

dis_content

DisContentRsp object

DIS数据源详细配置内容

api_content

ApiContentRsp object

API数据源配置
表11 IotdaContentRsp

参数

参数类型

描述

iotda_instance_id

String

IoTDA实例Id

最小长度：1

最大长度：256

rules

Array of IotdaContentRuleRsp objects

在IoTDA实例中要配置的转发规则，包含推送数据的资源空间和产品列表
表12 IotdaContentRuleRsp

参数

参数类型

描述

app_id

String

IoTDA中的资源空间Id

最小长度：1

最大长度：256

products

Array of strings

IoTDA中某资源空间Id下的产品列表

rule_actions

Array of IotdaRuleAction objects

IoTDA中rule_id和action_id列表
表13 IotdaRuleAction

参数

参数类型

描述

rule_id

String

IoTDA中的规则Id

最小长度：1

最大长度：256

action_id

String

IoTDA中推送数据动作ID

最小长度：1

最大长度：256
表14 DisContentRsp

参数

参数类型

描述

streamName

String

通道名称

最小长度：1

最大长度：256

ak

String

租户的AK

最小长度：1

最大长度：256

sk

String

租户的SK

最小长度：1

最大长度：256

projectId

String

项目id

最小长度：1

最大长度：128
表15 ApiContentRsp

参数

参数类型

描述

name

String

数据源名称

最小长度：1

最大长度：128

url

String

数据上报url

最小长度：1

最大长度：512

请求示例

{
  "name" : "test04",
  "type" : "API",
  "content" : {
    "api_content" : {
      "name" : "test04"
    }
  }
}

响应示例

状态码： 201

OK

{
  "id" : "125606569c5cf5fx7qk2",
  "name" : "test04",
  "type" : "API",
  "content" : {
    "api_content" : {
      "name" : "test04",
      "url" : "https://ip:port/v1/yourProjectId/datasources/yourDatasourceId/dev-data"
    },
    "created_time" : "2021-09-02T00:00:00Z",
    "modified_time" : "2021-09-02T00:00:00Z"
  }
}

状态码

状态码

描述

201

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

409

Conflict

500

Internal Server Error

错误码

请参见错误码。

父主题： 数据源配置

相关文档