新增连接器 - 千问AI平台

创建新的数据连接器，用于管理数据导入来源

POST

/api/v1/connector/dash/addConnector

cURL

curl -X POST "https://dashscope.aliyuncs.com/api/v1/connector/dash/addConnector" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connectorType": "FILE",
    "connectorName": "产品文档连接器",
    "description": "用于导入产品文档的文件连接器",
    "fileConnectorConfig": {
      "storeType": "PLATFORM"
    }
  }'

{
  "code": "Success",
  "status_code": 200,
  "data": {
    "connectorId": "conn_abc123"
  },
  "requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

当前 connectorType 仅支持 FILE 类型。storeType 为 CUSTOM 时需要额外传入 regionId 和 bucketName。

鉴权

string

header

必填

DashScope API Key，在控制台 API Key 页面获取。

请求体

application/json

enum<string>

必填

连接器类型，当前仅支持 FILE。

可选值：FILE

string

必填

连接器名称。

取值范围：length: 1–20

string

必填

连接器描述信息。

取值范围：length: 1–200

object

必填

文件连接器配置。

显示子属性

enum<string>

必填

存储类型：PLATFORM（平台托管）或 CUSTOM（自定义 OSS）。

可选值：PLATFORM,CUSTOM

string

OSS 地域 ID，当 storeType 为 CUSTOM 时需要。

string

OSS Bucket 名称，当 storeType 为 CUSTOM 时需要。

响应

200-application/json

string

响应码，成功时为 Success。

string

错误或提示信息，成功时为空字符串。

string

请求唯一标识，排查问题时请提供此 ID。

object

显示子属性

string

新创建的连接器 ID。

integer

业务状态码。成功为 200，参数错误等失败场景为 400。注意失败时 HTTP 状态码仍为 200，需根据本字段与 code 判断结果。

curl -X POST "https://dashscope.aliyuncs.com/api/v1/connector/dash/addConnector" \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "connectorType": "FILE", "connectorName": "产品文档连接器", "description": "用于导入产品文档的文件连接器", "fileConnectorConfig": { "storeType": "PLATFORM" } }'