CreateFileSystem--文件存储 vePFS-火山引擎

文档中心

导航

CreateFileSystem

最近更新时间：2024.06.25 14:48:50首次发布时间：2022.09.19 20:54:28

调用 CreateFileSystem 接口创建一个文件系统。

请求参数

参数	类型	是否必选	示例值	描述
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	文件系统描述信息。
Project	String	否	default	文件系统所属项目，默认为 `default`。
Capacity	Integer	否	100	文件系统容量，单位为 TiB。说明不同规格的容量限制说明，请参见产品规格。
Tags	Array of Tag	否	详情请参见请求示例	需要添加的标签信息。说明文件系统的标签信息需要满足一定规则，详细信息，请参见标签设置规则。
VpcId	String	否	vpc-rs5811nceqyov0x58x4****	私有网络ID。说明您可以调用 DescribeVpcs 接口查询私有网络 ID。
SubnetId	String	否	subnet-1g15j13jtzgu88ibuxwqp****	子网 ID。子网必须属于所选的可用区。说明子网是私有网络内的 IP 地址块。私有网络中的所有云资源都必须部署在子网内，子网为云资源分配私网 IP 地址，您可以调用 CreateSubnet 接口创建子网。您可以调用 DescribeSubnets 接口查询指定可用区内的所有子网列表信息，包括子网 ID。

参数	类型	是否必选	示例值	描述
Key	String	是	tag_00	标签键。
Type	String	是	Custom	标签类型，说明如下： `Custom`: 用户自定义标签。 `System`: 系统标签。
Value	String	是	tag_value00	标签值。

返回参数

参数	类型	示例值	描述
FileSystemId	String	vepfs-cnbj4386bc8a****	文件系统 ID。
OrderNO	String	Order705488740677732****	订单 ID。
Tags	Array of Tag	详情请参见返回示例	文件系统的标签信息，创建文件系统的同时添加标签时返回。

参数	类型	示例值	描述
Key	String	tag_00	标签键。
Type	String	Custom	标签类型，说明如下： `Custom`: 用户自定义标签。 `System`: 系统标签。
Value	String	tag_value00	标签值。

示例

请求示例

POST /?Action=CreateFileSystem&Version=2022-01-01 HTTP/1.1
Host: open.volcengineapi.com
Authorization: HMAC-SHA256 Credential=AKLTOGJhY2E1NTdkZGFmNDg0Yjk0ZDFiNjE5Y2NjZjI****/20230907/cn-beijing/vepfs/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
{
     "FileSystemName": "test",
     "FileSystemType": "VePFS",
     "ProtocolType": "VePFS",
     "StoreType": "Advance_100",
     "ZoneId": "cn-beijing-a",
     "ChargeType": "PayAsYouGo",
     "Tags": [
        {
             "Key": "tag_00",
             "Value": "tag_value_00",
             "Type": "Custom"
        },
        {
             "Key": "tag_01",
             "Value": "tag_value_01",
             "Type": "Custom"
        }
     ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202209161115480102081651062036****",
        "Action": "CreateFileSystem",
        "Version": "2022-01-01",
        "Service": "vepfs",
        "Region": "cn-beijing"
    },
    "Result": {
        "FileSystemId": "vepfs-cnbj4386bc8a****",
        "OrderNO": "Order714380929892930****",
        "Tags": [
            {
                 "Key": "tag_00",
                 "Value": "tag_value_00",
                 "Type": "Custom"
            },
            {
                 "Key": "tag_01",
                 "Value": "tag_value_01",
                 "Type": "Custom"
            }
         ]
    }
}