You need to enable JavaScript to run this app.
文档中心
文件存储 vePFS

文件存储 vePFS

复制全文
下载 pdf
文件系统
CreateFileSystem - 创建文件系统
复制全文
下载 pdf
CreateFileSystem - 创建文件系统
调用 CreateFileSystem 接口,创建一个文件系统。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:CreateFileSystem​
要执行的操作,取值:CreateFileSystem。​
​
Version string 必选 示例值:2022-01-01​
API的版本,取值:2022-01-01。​
​
FileSystemName string 必选 示例值:test​
文件系统名称。命名规范如下:​
  • 只能以中文或英文开头。​
  • 只能包含中文、字母、数字、半角句号(.)、下划线(_)或中划线(-)。​
  • 长度需要在 1~128 个字符内。​
​
ZoneId string 必选 示例值:cn-beijing-a​
可用区 ID。​
​
ChargeType string 必选 示例值:PayAsYouGo​
计费类型。取值说明如下:​
PayAsYouGo:按量计费。​
​
FileSystemType string 必选 示例值:VePFS​
文件系统类型,默认为 VePFS。​
​
StoreType string 必选 示例值:Advance_100​
文件系统规格,取值说明如下:​
  • Advance_100:100MB/s/TiB。​
  • Performance:性能版。​
  • Intelligent_Computing:智算版。​
​
ProtocolType string 必选 示例值:VePFS​
协议类型,默认为 VePFS。​
​
Description string 可选 示例值:Just-for-test​
文件系统描述信息。​
​
Capacity integer 可选 示例值:100​
文件系统容量,单位为 TiB。​
说明​
不同规格的容量限制说明,请参见产品规格。​
​
Tags object[] 可选 示例值:详情请参见请求示例。​
需要添加的标签信息。​
说明​
文件系统的标签信息需要满足一定规则,详细信息,请参见标签设置规则 。​
Key string 必选 示例值:tag_00​
标签键。​
​
Type string 必选 示例值:Custom​
标签类型,说明如下:​
  • Custom: 用户自定义标签。​
  • System: 系统标签。​
​
Value string 必选 示例值:tag_value00​
标签值。​
​
​
VpcId string 可选 示例值:vpc-rs5811nceqyov0x58x4****​
私有网络 ID。​
说明​
您可以调用 DescribeVpcs 接口查询私有网络 ID。​
​
SubnetId string 可选 示例值:subnet-1g15j13jtzgu88ibuxwqp****​
子网 ID。子网必须属于所选的可用区。​
说明​
  • 子网是私有网络内的 IP 地址块。私有网络中的所有云资源都必须部署在子网内,子网为云资源分配私网 IP 地址,您可以调用 CreateSubnet 接口创建子网。​
  • 您可以调用 DescribeSubnets 接口查询指定可用区内的所有子网列表信息,包括子网 ID。​
​
VersionNumber string 可选 示例值:1.4.0​
文件系统版本号。​
​
Project string 可选 示例值:default​
文件系统所属项目,默认为 default。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
FileSystemId string 示例值:vepfs-cnbj4386bc8a****​
文件系统 ID。​
​
OrderNO string 示例值:Order705488740677732****​
订单 ID。​
​
Tags object[] 示例值:详情请参见返回示例。​
文件系统的标签信息,创建文件系统的同时添加标签时返回。​
Key string 示例值:tag_00​
标签键。​
​
Type string 示例值:Custom​
标签类型,说明如下:​
  • Custom: 用户自定义标签。​
  • System: 系统标签。​
​
Value string 示例值:tag_value00​
标签值。​
​
​
​
​
请求示例​
​
POST /?Action=CreateFileSystem&Version=2022-01-01 HTTP/1.1​
Host: https://api.volcengine.com/api-explorer/?action=DescribeMountServices&groupName=%E6%96%87%E4%BB%B6%E7%B3%BB%E7%BB%9F&serviceCode=vepfs&version=2022-01-01​
Content-Type: application/json; charset=UTF-8​
X-Date: 20250728T063519Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250728/cn-beijing/vepfs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"FileSystemName": "test",​
"ZoneId": "cn-beijing-a",​
"ChargeType": "PayAsYouGo",​
"FileSystemType": "VePFS",​
"StoreType": "Advance_100",​
"ProtocolType": "VePFS",​
"Description": "Just-for-test",​
"Capacity": 100,​
"Tags": [​
{​
"Key": "tag_00",​
"Type": "Custom",​
"Value": "tag_value00"​
}​
],​
"VpcId": "vpc-rs5811nceqyov0x58x4****",​
"SubnetId": "subnet-1g15j13jtzgu88ibuxwqp****",​
"VersionNumber": "1.4.0",​
"Project": "default"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "2025072814352214722012517646EDF8",​
"Action": "CreateFileSystem",​
"Version": "2022-01-01",​
"Service": "vepfs",​
"Region": "cn-beijing"​
},​
"Result": {​
"FileSystemId": "vepfs-cnbj4386bc8a****",​
"OrderNO": "Order705488740677732****",​
"Tags": [​
{​
"Key": "tag_00",​
"Type": "Custom",​
"Value": "tag_value00"​
}​
]​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
500​
InternalError​
Service has some internal Error. Pls Contact With Admin.​
内部错误。​
​
​
最近更新时间:2025.08.06 10:44:08
这个页面对您有帮助吗?
有用
有用
无用
无用