全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

文件系统创建

最近更新时间:2025-02-08 16:09:26

1. 接口描述

本接口(CreateFileSystem)用于创建一个新的文件系统,文件系统类型包括:容量Ⅰ型、容量Ⅱ型、标准型、性能Ⅰ型。

2. 请求方法

POST

3. 请求参数

请求参数包含公共请求参数和接口请求参数。其中,公共请求参数是每个接口都会用到的请求参数,具体参见公共参数及签名机制;接口请求参数是各个接口所特有的,具体参见下方说明:

  1. 请求头

名称

是否必须

Content-Type

application/json

Accept

application/json

  1. 请求体

名称

类型

是否必须

描述

FileSystemName

string

文件系统名称。限制:小写字母开头,仅可包含小写字母、数字与连线符'-',长度3-40个字符,不可以连线符'-'结尾。

Region

string

文件系统所在地域。有效值:

  1. 容量Ⅰ型、容量Ⅱ型

  • cn-beijing-6(华北1(北京))

  • cn-northwest-3(西北3区(宁夏))

  • cn-northwest-4(西北4(海东))

  • cn-shanghai-2(华东1(上海))

  1. 标准型

  • cn-beijing-6(华北1(北京))

  1. 性能Ⅰ型:专属集群白名单开放,请提交工单申请。

  • cn-beijing-6(华北1(北京亦庄))

  • cn-ningbo-1(华东2(宁波))

  • cn-northwest-1(西北1(庆阳))

  • cn-northwest-3(西北3(宁夏))

  • cn-northwest-4(西北4(海东))

AvailZone

string

文件系统所在可用区,需与Region参数配合使用,有效值:

  1. 容量Ⅰ型、容量Ⅱ型

  • cn-beijing-6e

  • cn-northwest-3a

  • cn-northwest-4a

  • cn-shanghai-2c

  1. 标准型

  • cn-beijing-6e

  1. 性能Ⅰ型:专属集群白名单开放,请提交工单申请。

  • cn-beijing-6b

  • cn-ningbo-1a

  • cn-northwest-1a

  • cn-northwest-3a

  • cn-northwest-4a

ChargeType

string

文件系统计费类型。有效值:

  • monthly(预付费,包年包月)

  • dailySettlement(后付费,按量付费)

PurchaseTime

number

文件系统购买时长,仅购买包年包月时需填写。有效值:1~60,单位:月。

StoreClass

string

文件系统存储类型。有效值:

  • KPFS-capacity(容量Ⅰ型)

  • KPFS-capacity2(容量Ⅱ型)

  • KPFS-standard(标准型)

  • KPFS-P-S01(性能Ⅰ型)

Capacity

number

文件系统购买容量。单位TiB,有效值:

  • 20~102400(容量Ⅰ型)

  • 20~102400(容量Ⅱ型)

  • 10~102400(标准型)

  • 10~102400(性能Ⅰ型)

ChunkSize

number

条带块大小,仅性能Ⅰ型需填写。单位:Byte。

  • 小文件友好型:4KB

  • 均衡型:32KB

  • 大文件友好型:64KB

ClusterCode

string

存储池Code,为专属集群的UUID,仅性能Ⅰ型需填写。

Action

string

该参数为公共参数,取值:CreateFileSystem。

Version

string

该参数为公共参数,取值:2024-09-30。

4. 返回参数

名称

类型

描述

FileSystemId

string

文件系统的实例ID。

RequestId

string

唯一请求ID,每次请求都会返回。

5. 示例

请求示例

{
  "FileSystemName": "kpfs",
  "Region": "cn-beijing-6",
  "AvailZone":"cn-beijing-6e",
  "ChargeType": "monthly",
  "PurchaseTime": 1,
  "StoreClass": "KPFS-standard",
  "Capacity": 10,
  "Version": "2024-09-30",
  "Action": "CreateFileSystem"
}

返回示例

{
    "RequestId": "12df0962-777d-44b9-8d6f-e1a31db8d34b004",
    "FileSystemId": "9e2ce03cb2e844bca40db0b9d65d4971"
}

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容