创建文件系统

功能介绍

创建一个SFS Turbo文件系统。

URI

• URI格式

  POST /v1/{project_id}/sfs-turbo/shares

• 参数说明

  参数	是否必选	参数类型	描述
  project_id	是	String	项目ID。获取方法参见获取项目ID。

请求消息头

该操作消息头与普通请求一样，请参见表3。

请求消息

• 参数说明

  参数	是否必选	参数类型	描述
  share	是	Object	待创建的SFS Turbo文件系统信息。详细参数请参见表“share字段参数说明”。

• share字段参数说明

  参数	是否必选	参数类型	描述
  name	是	String	SFS Turbo文件系统的名称。长度为4~64位，必须以字母开头，可以包含字母、数字、中划线、下划线，不能包含其他的特殊字符，不区分大小写。
  share_proto	是	String	文件系统共享协议，有效值为NFS。NFS（Network File System），即网络文件系统。一种使用于分散式文件系统的协议，通过网络让不同的机器、不同的操作系统能够彼此分享数据。
  share_type	是	String	文件系统类型，有效值为STANDARD或者PERFORMANCE。当文件系统正在创建时，该字段不返回。 SFS Turbo上一代文件系统规格类型：标准型和标准型增强版填写STANDARD，性能型和性能型增强版填写PERFORMANCE。 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB：不校验该字段，填写STANDARD或者PERFORMANCE。
  size	是	Int	SFS Turbo上一代文件系统规格类型-文件系统容量：取值范围为500~32768，单位为GiB。 SFS Turbo上一代文件系统规格类型-增强版文件系统：在“metadata”字段中设置了expand_type="bandwidth"，则容量范围为10240~327680，单位为GiB。 20MB/s/TiB：在“metadata”字段中设置了expand_type="hpc"、hpc_bw="20M"，则容量范围为3686~1048576，单位为GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB->3686GiB, 4.8TiB->4915GiB，8.4TiB->8601GiB。 40MB/s/TiB：在“metadata”字段中设置了expand_type="hpc"、hpc_bw="40M"，则容量范围为1228~1048576，单位为GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB->3686GiB, 4.8TiB->4915GiB，8.4TiB->8601GiB。 125MB/s/TiB：在“metadata”字段中设置了expand_type="hpc"、hpc_bw="125M"，则容量范围为1228~1048576，单位为GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB->3686GiB, 4.8TiB->4915GiB，8.4TiB->8601GiB。 250MB/s/TiB：在“metadata”字段中设置了expand_type="hpc"、hpc_bw="250M"，则容量范围为1228~1048576，单位为GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB->3686GiB, 4.8TiB->4915GiB，8.4TiB->8601GiB。
  availability_zone	是	String	文件系统所在可用区(az)的编码。具体编码可在“地区和终端节点”查询。
  vpc_id	是	String	用户在某一区域下的VPC ID。VPC的ID可以从控制台或者参考的“查询VPC”章节获取。
  subnet_id	是	String	用户在VPC下面的子网的网络ID。子网的网络ID可以从虚拟私有云的控制台或者参考《虚拟私有云接口参考》的“查询子网”章节获取。
  security_group_id	是	String	用户在某一区域下的安全组ID。安全组ID可以从虚拟私有云的控制台或者参考《虚拟私有云接口参考》的“查询安全组”章节获取。
  backup_id	否	String	备份ID，从备份创建文件系统时为必选。 当前不支持。
  description	否	String	文件系统描述信息，长度为0~255。当前不支持。
  metadata	否	Object	创建文件系统的metadata信息，一到多个字典形式组织的键值对组成。详细参数请参见表"metadata字段参数说明”。

• metadata字段参数说明

  参数	是否必选	参数类型	描述
  expand_type	否	String	扩展类型；当文件系统正在创建时，该字段不返回。 创建增强型、20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB文件系统时，该参数必填。 创建增强型的文件系统，包括标准型-增强版和性能型-增强版，需要填写"bandwidth"。 创建20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB文件系统，需要填写"hpc"。
  crypt_key_id	否	String	要创加密文件系统，该字段传KMS服务专业版密钥的ID。密钥ID可以从数据加密服务的控制台或者参考《数据加密服务接口参考》的“查询密钥信息”章节获取。
  hpc_bw	否	String	文件系统的带宽规格。 创建20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB文件系统时，该参数必填。 20MB/s/TiB，填写"20M"。 40MB/s/TiB，填写"40M"。 125MB/s/TiB，填写"125M"。 250MB/s/TiB，填写"250M"。

• 以上信息的区域为同一区域，目前不支持跨区域。
• SFS Turbo将在填写的子网下创建两个私有IP和一个虚拟IP。
• 为保证您的正常使用，SFS Turbo将在填写的安全组下，开通111、445、2049、2051、2052、20048端口的入规则。
• 云服务器无法访问不在同一VPC下的文件系统，请保证创建文件系统时传入的VPC ID与待挂载文件系统云服务器在同一VPC。

• 请求样例

  {
    "share": {
      "name": "sfs-turbo-test", 
      "share_proto": "NFS",
      "share_type": "STANDARD",
      "size": 100,
      "availability_zone": "az1", 
      "vpc_id": "d651ea2b-2b20-4c6d-8bbf-2adcec18dac9", 
      "subnet_id": "b8884abe-f47b-4917-9f6c-f64825c365db",
      "security_group_id": "8c4ebbd0-6edf-4aae-8353-81ce6d06e1f4"
    }
  }

响应消息

• 响应要素说明

  参数	参数类型	描述
  id	String	创建的SFS Turbo文件系统ID。
  name	String	创建的SFS Turbo文件系统名称。
  status	String	SFS Turbo文件系统的状态（详情请参见SFS Turbo文件系统状态）。

• 响应样例

  {
      "id": "708c017c-54b5-429a-a098-7692e23fa518",
      "name": "sfs-turbo-test",
      "status": "100"
  }

状态码

• 正常

202

• 异常

请参见状态码。