创建文件系统

功能介绍

创建一个SFS Turbo文件系统。

URI

• URI格式

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

• 参数说明

  参数	是否必选	参数类型	描述
  project_id	是	String	项目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。 STANDARD：标准型文件系统，对应磁盘介质SAS。 PERFORMANCE：性能型文件系统，对应磁盘介质SSD。
  size	是	Int	普通文件系统容量，单位GB，取值范围500~32768。
  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。当前不支持。

• 以上信息的区域为同一区域，目前不支持跨区域。
• 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

• 异常

请参见状态码。