创建挂载点

更新时间：2026-11-04

描述

创建一个PFSL3实例的挂载点，返回domain。

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

请求结构

                Bash
                
            

                POST /?action=CreateL3MountTarget
x-bce-date: 2026-07-14T15:06:32Z
host: pfs.xx.baidubce.com  ## 请将xx替换为对应地域的服务域名，如北京为bj、保定为bd、苏州为su、阳泉为yq
content-type: application/json
Authorization: authorization string
version:v2
{
  "instanceId": "pfs-TVOxwG7Ymz",
  "vpcId": "vpc-zv9vg6xfs0ed",
  "subnetId": "sbn-v9rh607ykn7z",
   "name": "mount-test",
   "accessGroupName": "test001",
   "protocol": "bpfs",
   "ipAddress": "172.163.0.1"
}
            

请求头域

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

请求参数

参数名称	类型	是否必需	参数位置	描述
action	string	是	URL Query	本接口中固定为 CreateL3MountTarget
version	string	是	Request Header	API版本号，固定为v2
instanceId	string	是	Request Body	PFS实例ID
vpcId	string	是	Request Body	PFS实例vip所属VPC的短Id
subnetId	string	是	Request Body	MountTarget所属子网，subnet属于PFS实例所在vpc，为短id
name	string	否，默认default	Request Body	挂载点名称支持大小写字母、数字、中文、半角冒号（:）、下划线（_）或者短划线（-）必须以大小写字母或中文开头，长度为1~128个英文或中文字符个字符不可为空串
accessGroupName	string	否，默认DEFAULT_ACCESS_GROUP_NAME	Request Body	权限组名称
protocol	string	否，默认bpfs	Request Body	协议类型，当前只支持bpfs/nfs
ipAddress	string	否	Request Body	挂载点IP地址

响应

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

返回头域

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

返回参数

参数名称	类型	是否必须	参数位置	描述
requestId	string	是	Response Body	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
domain	string	是	Response Body	分配的服务dns，通过此dns执行文件系统挂载，即可访问服务
mountTargetId	string	是	Response Body	挂载点ID

请求示例

                Bash
                
            

                POST /?action=CreateL3MountTarget
x-bce-date: 2026-07-14T15:06:32Z
host: pfs.su.baidubce.com
content-type: application/json
Authorization: bce-auth-v1/ALTAKmfQK4ax0kCdJBWiEaHjEF/2026-07-14T15:00:14Z/1800/content-type;host;version;x-bce-date/991832557343eacee30581cb146775cef977707f28667382899b9631d4942efa
version:v2
{
   "instanceId": "pfs-TVOxwG7Ymz",
   "vpcId": "vpc-zv9vg6xfs0ed",
   "subnetId": "sbn-v9rh607ykn7z",
   "name": "mount-test",
   "accessGroupName": "test001",
   "protocol": "bpfs", ## 只支持bpfs和nfs两种协议类型
   "ipAddress": "172.163.0.1"
}
            

返回示例

                Bash
                
            

                HTTP/1.1 200 OK
x-bce-request-id: 50c1cfc4-3360-4357-bc0e-6453c693770f
Date: 14 Jul 2026 15:06:32 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
{
    "domain": "pfs-TVOxwG7Ymz.lb-45anz3dz.pfs.gz.baidubce.com", 
    "mountTargetId": "4b33767a336b55676a59694666493967796932722b513d3d", 
    "requestId": "50c1cfc4-3360-4357-bc0e-6453c693770f"
}
            

评价此篇文章

有帮助没帮助

挂载服务（极速型L2）相关接口

更新挂载点

百度智能云

并行文件存储 PFS

并行文件存储 PFS

创建挂载点