导入数据源
更新时间：2026-06-18
描述
本接口用于向运行中的 RapidFS 缓存实例导入指定数据源
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
使用该接口时，需要注意以下事项：
- 若数据源为跨账号 BOS 存储桶，需确保传入的 AK/SK 具备该 Bucket 的 READ、WRITE、LIST、MODIFY、GetObject 权限（或FullControl权限）
- 数据导入为异步任务，需要全量扫描数据源路径，文件数量越多，导入时间越长
- 操作前请确认数据源路径及权限配置，避免因权限不足或路径错误导致任务失败
请求结构
Plain Text
1POST /v{version}/datasrc?action=ImportDataSrc&clientToken={clientToken} HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4x-bce-accesskey: access key string
5
6{
7 "instanceId": "rapidfs-pNQrtEdPBr78",
8 "dataSrcName": "openapi-test-datasrc",
9 "bucket": "rapidfs-sandbox-test",
10 "otherAccount": false,
11 "bucketAK": "your-ak",
12 "bucketSK": "encrypted-sk",
13 "bucketStsToken": "sts-token",
14 "dirPrefix": "/test-prefix/",
15 "keepSymlink": true,
16 "authGroupId": "ag-zZAxb2My0yPp",
17 "description": "openapi test for create datasrc",
18 "quotaMiB": 1024
19}请求头域
除公共头域外，header可能还需要添加x-bce-accesskey用于密文传输。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| clientToken | String | 是 | Query参数 | 保证API调用的幂等性 |
| instanceId | String | 是 | RequestBody参数 | RapidFS 实例 ID |
| dataSrcName | String | 是 | RequestBody参数 | 数据源名称 |
| bucket | String | 是 | RequestBody参数 | 数据源的 BOS Bucket（当前只支持同地域的存储桶） |
| otherAccount | Boolean | 否 | RequestBody参数 | 是否为其他账号的 bucket，若为true则需要提供导入 Bucket 带读写权限的AK/SK，默认 false |
| bucketAK | String | 否 | RequestBody参数 | otherAccount 为 true 时必填，无需加密 |
| bucketSK | String | 否 | RequestBody参数 | otherAccount 为 true 时必填，bucketSK字段需要基于请求 header x-bce-accesskey 对应的 secretkey 进行加密传输，详见密码加密传输规范定义。可参考 bce-python-sdk aes128_encrypt_16char_key()函数实现 |
| bucketStsToken | String | 否 | RequestBody参数 | otherAccount 为 true 时有效，无需加密 |
| dirPrefix | String | 否 | RequestBody参数 | BOS Bucket的目录前缀，默认值为/。例如，用户想要导入bos:/bucket_name/model_data/2025/下所有对象，则dirPrefix值为/model_data/2025/ |
| keepSymlink | Boolean | 否 | RequestBody参数 | 是否保留 BOS 软链，保留软链会降低数据源导入效率，以及后续增量元数据同步效率，默认 false |
| authGroupId | String | 否 | RequestBody参数 | 权限组ID，默认权限组 ID 为 AG-RAPIDFS_DEFAULT_AUTHGROUP_ID |
| description | String | 否 | RequestBody参数 | 数据源描述信息 |
| quotaMiB | int | 否 | RequestBody参数 | 该数据源的容量配额，表示该数据源的可用最大容量，不能超过实例的缓存总容量 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| dataSrcId | String | 数据源唯一ID |
请求示例
Plain Text
1POST /v2/datasrc?action=ImportDataSrc&clientToken=62b942bd-3a6f-4831-b39e-eb9109e66b5 HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4{
5 "instanceId": "rapidfs-pNQrtEdPBr78",
6 "dataSrcName": "openapi-test-datasrc",
7 "description": "openapi test for create datasrc",
8 "bucket": "rapidfs-sandbox-test",
9 "otherAccount": false,
10 "dirPrefix": "/test-prefix/",
11 "keepSymlink": true,
12 "authGroupId": "ag-zZAxb2My0yPp",
13 "quotaMiB" : 1024
14}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
4{
5 "dataSrcId": "ds-kq68w8sds"
6}评价此篇文章