华为云计算 云知识 创建文件系统CreateShare
创建文件系统CreateShare

 

接口说明

创建文件系统。

URL
POST  https://sfs-turbo.cn-north-4.myhuaweicloud.com/v1/{project_id}/sfs-turbo/shares 
请求参数
名称 类型 IN 必选 描述
X-Auth-Token
 
string header

帐号的token

Content-Type
 
string header

MIME类型

project_id
 
string path

项目ID

Body参数
名称 类型 必选 描述
share
 
Share object

创建文件系统参数body

bss_param
 
BssInfo object

包周期付费模式,需要填写该参数

参数:
share
名称 类型 必选 描述
availability_zone
 
string

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

description
 
string

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

enterprise_project_id
 
string

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

metadata
 
Metadata object

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

name
 
string

SFS Turbo文件系统的名称。长度为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

subnet_id
 
string

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

vpc_id
 
string

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

backup_id
 
string

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

参数:
share.metadata
名称 类型 必选 描述
crypt_key_id
 
string

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

dedicated_flavor
 
string

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

dedicated_storage_id
 
string

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

expand_type
 
string

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

hpc_bw
 
string

hpc型带宽,仅创建hpc型需要

参数:
bss_param
名称 类型 必选 描述
is_auto_renew
 
long

是否自动续费

period_num
 
long

包周期订购的周期数

period_type
 
long

包周期的类型,可选包年或包月,2 表示包月,3 表示包年

is_auto_pay
 
long

是否生成订单后自动扣款

返回参数
返回码: 202

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

名称 类型 必选 描述
id
 
string

创建的SFS Turbo文件系统ID。

name
 
string

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

status
 
string

SFS Turbo文件系统的状态

请求示例
示例 1
 
{ "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。

示例 1
 
{
"id": "708c017c-54b5-429a-a098-7692e23fa518",
"name": "sfs-turbo-test",
"status": "100"
}
SDK
点击  弹性文件 服务(SFS Turbo) (SFSTurbo) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明

 

上一篇:使用CDN加速如何保障网站数据安全,CDN有什么安全防护能力? 下一篇:删除路由表DeleteRouteTable

弹性文件服务 SFS 

 

提供按需扩展的高性能文件存储(NAS),可为云上多个弹性云服务器(Elastic Cloud Server,ECS),容器(CCE&CCI),裸金属服务器(BMS)提供共享访问。