更新挂载点

更新时间：2026-11-02

描述

该接口用于编辑单个 L3 挂载点的信息，可用于修改挂载点名称、切换绑定的权限组、启用或禁用挂载点。

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

请求结构

                Bash
                
            

                    POST /?action=UpdateL3MountTarget HTTP/1.1
    Host: pfs.bj.baidubce.com
    content-type: application/json
    version: v2
    Authorization: authorization string

    {
        "instanceId": "pfs-F571zo0FMD",
        "mountTargetId": "4b33767a336b55676a59694666493967796932722b513d3d",
        "admissionStatus": 1,
        "name": "testNewName",
        "accessGroupName": "test001"
    }
            

请求头域

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

请求参数

参数名称	类型	是否必需	参数位置	描述
action	String	是	URL Query	本接口固定为 UpdateL3MountTarget
instanceId	String	是	Request Body	PFS 实例 ID
mountTargetId	String	是	Request Body	挂载点 ID
admissionStatus	Integer	否	Request Body	传入该值时更新挂载点禁用状态，传 1 禁用、传 0 启用；不传表示不修改状态
name	String	否	Request Body	传入该值时更新挂载点名称。支持大小写字母、数字、中文、半角冒号（:）、下划线（_）或者短划线（-）必须以大小写字母或中文开头，长度为1~128个英文或中文字符个字符不可为空串不传表示不改名
accessGroupName	String	否	Request Body	传入该值时更新绑定的权限组；不传表示不修改

返回状态码

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

返回头域

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

返回参数

参数名称	类型	是否必需	参数位置	描述
requestId	String	是	Response Body	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

请求示例

                Bash
                
            

                    POST /?action=UpdateL3MountTarget HTTP/1.1
    Host: pfs.su.baidubce.com
    content-type: application/json
    version: v2
    Authorization: bce-auth-v1/ALTAKmfQK4ax0kCdJBWiEaHjEF/2026-07-14T15:08:22Z/1800/content-type;host;version;x-bce-date/991832557343eacee30581cb146775cef977707f28667382899b9631d4942efa

    {
        "instanceId": "pfs-F571zo0FMD",
        "mountTargetId": "4b33767a336b55676a59694666493967796932722b513d3d",
        "admissionStatus": 1,
        "name": "testNewName",
        "accessGroupName": "test001"
    }
            

响应示例

                Bash
                
            

                    HTTP/1.1 200 OK
    x-bce-request-id: 5fbf3f35-ee1f-4123-a28c-d6075368fb56
    Date: Tue, 14 Jul 2026 15:08:22 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS

    {
        "requestId": "5fbf3f35-ee1f-4123-a28c-d6075368fb56"
    }
            

评价此篇文章

有帮助没帮助

创建挂载点

删除挂载点

百度智能云

并行文件存储 PFS

并行文件存储 PFS

更新挂载点