華為云計(jì)算 云知識(shí) 創(chuàng)建文件系統(tǒng)CreateShare
創(chuàng)建文件系統(tǒng)CreateShare

 

接口說(shuō)明

創(chuàng)建文件系統(tǒng)。

URL
POST  https://sfs-turbo.cn-north-4.myhuaweicloud.com/v1/{project_id}/sfs-turbo/shares 
請(qǐng)求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
string header

帳號(hào)的token

Content-Type
 
string header

MIME類型

project_id
 
string path

項(xiàng)目ID

Body參數(shù)
名稱 類型 必選 描述
share
 
Share object

創(chuàng)建文件系統(tǒng)參數(shù)body

bss_param
 
BssInfo object

包周期付費(fèi)模式,需要填寫該參數(shù)

參數(shù):
share
名稱 類型 必選 描述
availability_zone
 
string

文件系統(tǒng)所在可用區(qū)(az)的編碼

description
 
string

文件系統(tǒng)描述信息,長(zhǎng)度為0~255。當(dāng)前不支持。

enterprise_project_id
 
string

創(chuàng)建文件系統(tǒng)時(shí),給文件系統(tǒng)綁定的企業(yè)項(xiàng)目ID。

metadata
 
Metadata object

創(chuàng)建文件系統(tǒng)的metadata信息,一到多個(gè)字典形式組織的鍵值對(duì)組成。

name
 
string

SFS Turbo文件系統(tǒng)的名稱。長(zhǎng)度為4~64位,必須以字母開頭,可以包含字母、數(shù)字、中劃線、下劃線,不能包含其他的特殊字符,不區(qū)分大小寫。

security_group_id
 
string

用戶在某一區(qū)域下的安全組ID。

share_proto
 
string

文件系統(tǒng)共享協(xié)議,有效值為NFS。NFS(Network File System),即網(wǎng)絡(luò)文件系統(tǒng)。一種使用于分散式文件系統(tǒng)的協(xié)議,通過(guò)網(wǎng)絡(luò)讓不同的機(jī)器、不同的操作系統(tǒng)能夠彼此分享數(shù)據(jù)。

share_type
 
string

文件系統(tǒng)類型,有效值為STANDARD或者PERFORMANCE。

size
 
integer

普通文件系統(tǒng)容量,單位GB,取值范圍500~32768。 增強(qiáng)型文件系統(tǒng),即在“metadata”字段中設(shè)置了expand_type字段,則容量范圍是10240~327680

subnet_id
 
string

用戶在VPC下面的子網(wǎng)的網(wǎng)絡(luò)ID。

vpc_id
 
string

用戶在某一區(qū)域下的VPC ID。

backup_id
 
string

備份ID,從備份創(chuàng)建文件系統(tǒng)時(shí)為必選。

參數(shù):
share.metadata
名稱 類型 必選 描述
crypt_key_id
 
string

要?jiǎng)?chuàng)加密文件系統(tǒng),該字段傳KMS服務(wù)專業(yè)版密鑰的ID。

dedicated_flavor
 
string

創(chuàng)專屬文件系統(tǒng),要?jiǎng)?chuàng)建的虛擬機(jī)的規(guī)格。

dedicated_storage_id
 
string

創(chuàng)專屬文件系統(tǒng),要指定一個(gè) 專屬分布式存儲(chǔ) 的ID。

expand_type
 
string

擴(kuò)展類型。當(dāng)前有效值為bandwidth,即創(chuàng)建增強(qiáng)型的文件系統(tǒng)。

hpc_bw
 
string

hpc型帶寬,僅創(chuàng)建hpc型需要

參數(shù):
bss_param
名稱 類型 必選 描述
is_auto_renew
 
long

是否自動(dòng)續(xù)費(fèi)

period_num
 
long

包周期訂購(gòu)的周期數(shù)

period_type
 
long

包周期的類型,可選包年或包月,2 表示包月,3 表示包年

is_auto_pay
 
long

是否生成訂單后自動(dòng)扣款

返回參數(shù)
返回碼: 202

創(chuàng)建請(qǐng)求下發(fā)成功返回body。

名稱 類型 必選 描述
id
 
string

創(chuàng)建的SFS Turbo文件系統(tǒng)ID。

name
 
string

創(chuàng)建的SFS Turbo文件系統(tǒng)名稱。

status
 
string

SFS Turbo文件系統(tǒng)的狀態(tài)

請(qǐng)求示例
示例 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

創(chuàng)建請(qǐng)求下發(fā)成功返回body。

示例 1
 
{
"id": "708c017c-54b5-429a-a098-7692e23fa518",
"name": "sfs-turbo-test",
"status": "100"
}
SDK
點(diǎn)擊  彈性文件 服務(wù)(SFS Turbo) (SFSTurbo) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對(duì)應(yīng)語(yǔ)言類型的【使用】目錄下。
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說(shuō)明