CreateMountPoint - 创建挂载点--文件存储 NAS-火山引擎

文档中心

立即注册

导航

CreateMountPoint - 创建挂载点

最近更新时间：2025.05.16 14:12:52首次发布时间：2023.07.10 11:11:52

调用 CreateMountPoint 创建挂载点。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	CreateMountPoint	要执行的操作，取值：CreateMountPoint。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
FileSystemId	String	是	enas-cnbj18bcb923****	文件系统 ID。
VpcId	String	是	vpc-30uexwepls3cw7r2qr2h2****	私有网络 ID。说明您可以调用 DescribeVpcs 接口查询私有网络 ID。
SubnetId	String	是	subnet-3jhaxpk3qwrgg3pncme77****	子网 ID。说明您可以调用 DescribeSubnets 接口查询指定可用区内的所有子网 ID。
PermissionGroupId	String	是	pgroup-77afc370****	权限组 ID。说明您可以调用 DescribePermissionGroups 接口查询所有可用的权限组 ID。
MountPointName	String	是	MountPoint2	挂载点名称。命名规范如下：不能以数字、中划线（-）开头。只能包含中文、字母、数字、下划线（_）和中划线（-）。长度需要在 1～128 个字符内。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
MountPointId	String	mount-n7db****	挂载点 ID。

请求示例

POST /?Action=CreateMountPoint&Version=2022-01-01 HTTP/1.1
Host: filenas.volcengineapi.com
Authorization: HMAC-SHA256 Credential=AKLTOGJhY2E1NTdkZGFmNDg0Yjk0ZDFiNjE5Y2NjZjI****/20230907/cn-beijing/filenas/request, SignedHeaders=host;x-date;x-content-sha256;content-type, Signature=7f1119a75111535b1d6e7929700f22e1474af0fb4fe26c59f5ac5cdba0cc****
Content-Type: application/json; charset=utf-8
X-Content-Sha256: 567112abe45bd6a09504fd244237f14c0ba120491da0d35097afd54d87bd****
X-Date: 20230907T124910Z
{
    "FileSystemId": "enas-cnbj18bcb923****",
    "VpcId": "vpc-30uexwepls3cw7r2qr2h2****",
    "SubnetId": "subnet-3jhaxpk3qwrgg3pncme77****",
    "PermissionGroupId": "pgroup-77afc370****",
    "MountPointName": "MountPoint2"
}

返回示例

{
    "ResponseMetadata":{
        "RequestId":"92983677-0255-4ea0-a084-0b5e45a093e3",
        "Action":"CreateMountPoint",
        "Version":"2022-01-01",
        "Service":"FileNAS",
        "Region":"cn-beijing"
    },
    "Result":{
        "MountPointId": "mount-n7db****"
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter	The specified parameter format is invalid.	参数格式无效。
400	MissingParameter.FileSystemId	The required parameter FileSystemId is not supplied.	文件系统 ID 不能为空。
400	MissingParameter.MountPointName	The required parameter MountPointName is not supplied.	参数 MountPointName 不能为空。
400	MissingParameter.VpcId	The required parameter VpcId is not supplied.	参数 VpcId 不能为空。
400	MissingParameter.SubnetId	The required parameter SubnetId is not supplied.	参数 SubnetId 不能为空。
400	MissingParameter.PermissionGroupId	The required parameter PermissionGroupId is not supplied.	参数 PermissionGroupId 不能为空。
400	InvalidParameter.MountPointName	The specified parameter MountPointName is invalid.	参数 MountPointName 不合法。
400	AlreadyExist.MountPointName	The specified MountPoint is already exist.	指定名称的挂载点已存在。
400	LimitExceeded.MountPointNumber	The specified number of MountPoint of the specified FileSystem exceeds the limit.	指定文件系统的挂载点个数已经达到上限。
400	AlreadyExist.Vpc	There is existing MountPoint of the FileSystem which in the specified VpcId.	该文件系统已存在挂载点处于该私有网络。
404	NotFound.Subnet	The specified Subnet is not exist or has been deleted.	子网不存在或已删除。
404	NotFound.Vpc	The specified Vpc is not exist or has been deleted.	私有网络不存在或已删除。
500	InternalError	An internal error has occurred.	内部错误。