更新时间:2022-02-24 GMT+08:00
分享

创建文件系统

功能介绍

创建文件系统。

调试

您可以在API Explorer中调试该接口。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

帐号的token

Content-Type

String

MIME类型

表3 请求Body参数

参数

是否必选

参数类型

描述

share

Share object

创建文件系统参数body

表4 Share

参数

是否必选

参数类型

描述

availability_zone

String

文件系统所在可用区(az)的编码

description

String

文件系统描述信息,长度为0~255。当前不支持。

最小长度:0

最大长度:255

enterprise_project_id

String

创建文件系统时,给文件系统绑定的企业项目ID。

metadata

Metadata object

创建文件系统的metadata信息,一到多个字典形式组织的键值对组成。

name

String

SFS Turbo文件系统的名称。长度为4~64位,必须以字母开头,可以包含字母、数字、中划线、下划线,不能包含其他的特殊字符,不区分大小写。

最小长度:4

最大长度:64

security_group_id

String

用户在某一区域下的安全组ID。

share_proto

String

文件系统共享协议,有效值为NFS。NFS(Network File System),即网络文件系统。一种使用于分散式文件系统的协议,通过网络让不同的机器、不同的操作系统能够彼此分享数据。

share_type

String

文件系统类型,有效值为STANDARD或者PERFORMANCE。

size

Integer

普通文件系统容量,单位GB,取值范围500~32768。 增强型文件系统,即在“metadata”字段中设置了expand_type字段,则容量范围是10240~327680

最小值:500

最大值:327680

subnet_id

String

用户在VPC下面的子网的网络ID。

vpc_id

String

用户在某一区域下的VPC ID。

backup_id

String

备份ID,从备份创建文件系统时为必选。

表5 Metadata

参数

是否必选

参数类型

描述

crypt_key_id

String

要创加密文件系统,该字段传KMS服务专业版密钥的ID。

dedicated_flavor

String

创专属文件系统,要创建的虚拟机的规格。

dedicated_storage_id

String

创专属文件系统,要指定一个专属分布式存储的ID。

expand_type

String

扩展类型。当前有效值为bandwidth,即创建增强型的文件系统。

响应参数

状态码: 202

表6 响应Body参数

参数

参数类型

描述

id

String

创建的SFS Turbo文件系统ID。

name

String

创建的SFS Turbo文件系统名称。

status

String

SFS Turbo文件系统的状态

请求示例

{
  "share" : {
    "availability_zone" : "az1",
    "metadata" : {
      "crypt_key_id" : "015bf4b8-73cc-4235-8595-46931de7dfd0",
      "dedicated_flavor" : "c3.large.4",
      "dedicated_storage_id" : "198f0704-63fc-4d85-b15d-c25caa4d3264"
    },
    "name" : "sfs-turbo-test",
    "security_group_id" : "8c4ebbd0-6edf-4aae-8353-81ce6d06e1f4",
    "share_proto" : "NFS",
    "share_type" : "STANDARD",
    "size" : 500,
    "subnet_id" : "b8884abe-f47b-4917-9f6c-f64825c365db",
    "vpc_id" : "d651ea2b-2b20-4c6d-8bbf-2adcec18dac9"
  }
}

响应示例

状态码: 202

创建请求下发成功返回body。

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

状态码

状态码

描述

202

创建请求下发成功返回body。

错误码

请参见错误码

分享:

    相关文档

    相关产品

关闭导读