修改数据源

更新时间：2026-10-29

描述

本接口用于修改 RapidFS 实例数据源的可变属性，包括：是否保留软链、权限组、挂载服务配置及描述信息；数据源ID、类型等核心属性不可变更。

您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。

请求结构

                Bash
                
            

                POST /v{version}/datasrc?action=ModifyDataSrc&clientToken={clientToken} HTTP/1.1
Host: rapidfs.bj.baidubce.com
Authorization: authorization string

{
    "instanceId": "rapidfs-nzQhBpIz",
    "dataSrcId": "ds-kq68w8sds",
    "keepSymlink": true,
    "authGroupId": "ag-sersdflk",
    "description": "new description",
    "quotaMiB": -1,
    "mountServiceBindings" : [ {
        "mountServiceId" : "MNTSVC-RAPIDFS_DEFAULT_ID",
        "logicalMountPath" : "dir_name"
    } ]
}
            

请求头域

除公共头域外，无其他特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号
clientToken	String	是	Query参数	保证API调用的幂等性
dataSrcId	String	是	RequestBody参数	待修改的数据源 ID
instanceId	String	是	RequestBody参数	所属 RapidFS 实例唯一 ID
bucketAK	String	否	RequestBody参数	修改 bucket 凭证。仅 otherAccount == true 的数据源可改；必须与 bucketSK 成对提供，只给其中一个报错 bucketAK and bucketSK must be provided together；不传则不修改凭证
bucketSK	String	否	RequestBody参数	修改 bucket 凭证，加密方式与创建数据源一致（Console AES / OpenAPI Cipher，按 X-Bce-Accesskey 头区分）；必须与 bucketAK 成对提供
keepSymlink	Boolean	否	RequestBody参数	是否保留软链，保留软链会降低数据源导入效率，以及后续增量元数据同步效率
authGroupId	String	否	RequestBody参数	权限组Id
mountServiceBindings	List	否	RequestBody参数	数据源绑定的目标全集，元素结构为 MountServiceBinding。不传：不修改绑定；传入（含空列表）：以列表为准整体覆盖该数据源的绑定，列表中新增的挂载服务执行绑定，列表中去掉的执行摘除，路径变化的执行改绑；空列表表示摘除全部绑定。校验规则同创建，查重时排除本数据源自身、包含其他绑定中和变更中的路径；数据源状态为 RUNNING 或 CHANGE_FAILED 时允许修改；绑定变更异步执行，进度见 DataSrcInfo.mountServiceBindings[].status；数据源变更中（CHANGING）再次修改返回 BadRequest；BIND_FAILED / UNBIND_FAILED 的绑定可再次提交修改重试
description	String	否	RequestBody参数	数据源描述信息，不超过256个字符
quotaMiB	int	否	RequestBody参数	该数据源的容量配额，表示该数据源的可用最大容量，不能超过实例的缓存总容量。-1 表示取消对数据源的容量限制

返回状态码

成功返回200，失败返回见错误码。

返回头域

除公共头域外，无其他特殊头域。

返回参数

无。

请求示例

                Bash
                
            

                POST /v2/datasrc?action=ModifyDataSrc&clientToken=62b942bd-3a6f-4831-b39e-eb9109e66b5 HTTP/1.1
Host: rapidfs.bj.baidubce.com
Authorization: authorization string 
{
    "instanceId": "rapidfs-nzQhBpIz",
    "dataSrcId": "ds-kq68w8sds",
    "keepSymlink": true,
    "authGroupId": "ag-sersdflk",
    "description": "new description",
    "quotaMiB": -1,
    "mountServiceBindings" : [ {
        "mountServiceId" : "MNTSVC-RAPIDFS_DEFAULT_ID",
        "logicalMountPath" : "dir_name"
    } ]
}
            

返回示例

                Bash
                
                HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
{}

评价此篇文章

有帮助没帮助

查询单个数据源详情

移除数据源

百度智能云

极速文件缓存 RapidFS

极速文件缓存 RapidFS

修改数据源