全部文档
当前文档
最近更新时间：2025-09-25 12:57:19
本接口（CreateFileSystem）用于创建一个新的文件系统，文件系统类型包括：容量Ⅰ型、容量Ⅱ型、标准型、性能Ⅰ型、性能Ⅱ型。
POST
请求参数包含公共请求参数和接口请求参数。其中，公共请求参数是每个接口都会用到的请求参数，具体参见公共参数及签名机制；接口请求参数是各个接口所特有的，具体参见下方说明：
请求头
名称 | 是否必须 | 值 |
|---|---|---|
Content-Type | 是 | application/json |
Accept | 是 | application/json |
请求体
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
FileSystemName | string | 是 | 文件系统名称。
|
Region | string | 是 | 文件系统所在地域。有效值：
|
AvailZone | string | 是 | 文件系统所在可用区，需与Region参数配合使用，有效值：
|
ChargeType | string | 是 | 文件系统计费类型。有效值：
|
PurchaseTime | number | 是 | 文件系统购买时长，仅购买包年包月时需填写。有效值：1~60，单位：月。 |
StoreClass | string | 是 | 文件系统存储类型。有效值：
|
Capacity | number | 是 | 文件系统购买容量。单位TiB，有效值：
|
ChunkSize | number | 是 | 条带块大小，仅性能Ⅰ型、性能Ⅱ型需填写。单位：Byte。
|
ClusterCode | string | 是 | 存储池Code，为集群的唯一标识，仅性能Ⅰ型、性能Ⅱ型需填写。 |
Action | string | 是 | 该参数为公共参数，取值：CreateFileSystem。 |
Version | string | 是 | 该参数为公共参数，取值：2024-09-30。 |
名称 | 类型 | 描述 |
|---|---|---|
FileSystemId | string | 文件系统的实例ID。 |
RequestId | string | 唯一请求ID，每次请求都会返回。 |
请求示例
curl --location 'kpfs.api.ksyun.com' \
--header 'X-action: CreateFileSystem' \
--header 'X-version: 2024-09-30' \
--header 'Content-Type: application/json' \
--header 'X-Amz-Content-Sha256: beaead3198f7da1e70d03ab969765e0821b24fc913697e929e726aeaebf0eba3' \
--header 'X-Amz-Date: 20250923T121457Z' \
--header 'Authorization: AWS4-HMAC-SHA256 Credential=AKLTY11BXipTOaxr5MipHNzX/20250923/us-east-1/kpfs/aws4_request, SignedHeaders=content-length;content-type;host;x-action;x-amz-content-sha256;x-amz-date;x-version, Signature=5d4e9145c334d9de438d074501299c416c4d791b944b918a3eb200cd08ca63e4' \
--data '{
"FileSystemName": "kpfs",
"Region": "cn-beijing-6",
"AvailZone":"cn-beijing-6e",
"ChargeType": "monthly",
"PurchaseTime": 1,
"StoreClass": "KPFS-standard",
"Capacity": 10,
}'返回示例
{
"RequestId": "12df0962-777d-44b9-8d6f-e1a31db8d34b004",
"FileSystemId": "9e2ce03cb2e844bca40db0b9d65d4971"
}纯净模式