移除数据源
更新时间:2026-06-18
描述
本接口用于移除数据源,该操作不可逆,移除后,数据源信息和缓存数据无法恢复,请谨慎执行。为确保安全,删除流程采用二次确认机制,具体步骤如下:
- 第一步(生成临时令牌):调用本接口获取 token ,该令牌有效期为 1 分钟,超时后需重新生成。
- 第二步(二次确认删除):在令牌有效期内,再次调用本接口,并在请求体中携带第一步返回的 token。后端校验令牌有效性后,才会执行最终删除操作。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口,免去您计算签名的困扰。运行成功后,API Explorer 可以自动生成 SDK 代码示例。
使用该接口时,需要注意以下事项:
- 临时令牌(token)仅限当前请求会话使用
- 若未在 1 分钟内完成二次调用,则需重新发起流程
- 建议在操作前确保实例数据已备份,避免误删导致业务中断
此机制通过双重确认降低误操作风险,请严格按照流程执行。强烈建议用户在执行移除操作前,先对服务进行断流操作(可通过权限组功能来拒绝所有的ip访问),确认对业务无影响后再进行相应的移除操作。
请求结构
Plain Text
1POST /v{version}/datasrc?action=RemoveDataSrc&clientToken={clientToken} HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "instanceId": "rapidfs-6MlqHdszZuJH",
7 "dataSrcId": "ds-qC5U4rfrhcUv",
8 "token": "SfCJYM4QZ7NndS/cHDnMxZSvC923plZLQKtYXLLzAfs=.MTc1MDc0NzI2NzI2OA=="
9}
请求头域
除公共头域外,无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| clientToken | String | 是 | Query参数 | 保证API调用的幂等性 |
| dataSrcId | String | 是 | RequestBody参数 | 待释放的数据源ID |
| instanceId | String | 是 | RequestBody参数 | 所属RapidFS 实例ID |
| token | String | 否 | RequestBody参数 | 当参数为空或未传值时,系统会生成并返回一个临时令牌;当传入token时,系统会进行校验,并根据校验结果决定是否接受释放操作 |
返回状态码
成功返回200,失败返回见错误码。
返回头域
除公共头域外,无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| token | String | 临时令牌 |
请求示例
第二次删除:
Plain Text
1POST /v2/datasrc?action=RemoveDataSrc&clientToken=62b942bd-3a6f-4831-b39e-eb9109e66b5 HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4{
5 "instanceId": "rapidfs-6MlqHdszZuJH",
6 "dataSrcId": "ds-qC5U4rfrhcUv",
7 "token": "SfCJYM4QZ7NndS/cHDnMxZSvC923plZLQKtYXLLzAfs=.MTc1MDc0NzI2NzI2OA=="
8}
返回示例
当第二步调用,执行了真正的释放操作后,不会返回 token 字段。
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}
评价此篇文章
