更新时间:2022-02-22 GMT+08:00

创建文件系统

功能介绍

创建一个SFS Turbo文件系统。

URI

  • URI格式

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

  • 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

    项目ID。获取方法参见获取项目ID

请求消息

  • 参数说明

    参数

    是否必选

    参数类型

    描述

    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

    Integer

    普通文件系统容量,单位GB,取值范围500~32768(公测用户最小可以创建40GB)。

    availability_zone

    String

    文件系统所在可用区(az)的编码。具体编码可在“地区和终端节点”查询。

    vpc_id

    String

    用户在某一区域下的VPC ID。VPC的ID可以从控制台或者参考的“查询VPC”章节获取。

    subnet_id

    String

    用户在VPC下面的子网的网络ID。子网的网络ID可以从虚拟私有云的控制台或者参考《虚拟私有云接口参考》的“查询子网”章节获取。

    security_group_id

    String

    用户在某一区域下的安全组ID。安全组ID可以从虚拟私有云的控制台或者参考《虚拟私有云接口参考》的“查询安全组”章节获取。

    enterprise_project_id

    String

    创建文件系统时,给文件系统绑定的企业项目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

  • 异常

请参见状态码