更新时间:2022-07-13 GMT+08:00
分享

修改数据源

功能介绍

修改数据源

调试

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

URI

PUT /v1/{project_id}/datasources/{datasource_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

projectid

最小长度:1

最大长度:128

datasource_id

String

数据源id

最小长度:1

最大长度:256

请求参数

表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

响应参数

状态码: 200

表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" : "test03",
  "type" : "API",
  "content" : {
    "api_content" : {
      "name" : "test03"
    }
  }
}

响应示例

状态码: 200

successful

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

状态码

状态码

描述

200

successful

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

409

Conflict

500

Internal Server Error

错误码

请参见错误码

相关文档