華為云計算 云知識 獲取文件系統(tǒng)列表ListShares
獲取文件系統(tǒng)列表ListShares

 

功能介紹

獲取文件系統(tǒng)列表

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動認(rèn)證鑒權(quán)。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

GET /v1/{project_id}/sfs-turbo/shares/detail

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

操作用戶的項(xiàng)目ID。

表2 Query參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

limit

Long

返回的文件系統(tǒng)個數(shù),最大值為200。

最小值:0

最大值:200

offset

Long

文件系統(tǒng)查詢個數(shù)的偏移量。

最小值:0

請求參數(shù)

表3 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

帳號的token

Content-Type

String

MIME類型

響應(yīng)參數(shù)

狀態(tài)碼: 200

表4 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

shares

Array of ShareInfo objects

SFS Turbo文件系統(tǒng)的列表。

count

Integer

SFS Turbo文件系統(tǒng)的數(shù)量。

表5 ShareInfo

參數(shù)

參數(shù)類型

描述

action_progress

ActionProgress object

SFS Turbo文件系統(tǒng)的任務(wù)進(jìn)度。例如創(chuàng)建文件系統(tǒng)進(jìn)度。

version

String

SFS Turbo文件系統(tǒng)的版本號。

avail_capacity

String

SFS Turbo文件系統(tǒng)剩余容量,單位GB。

availability_zone

String

SFS Turbo文件系統(tǒng)所在可用區(qū)編碼。

az_name

String

SFS Turbo文件系統(tǒng)所在可用區(qū)名稱。

created_at

String

創(chuàng)建時間。UTC時間,例如:2018-11-19T04:02:03

crypt_key_id

String

用戶指定的加密密鑰ID,非加密盤時不返回。

expand_type

String

如果是增強(qiáng)型文件系統(tǒng),該字段返回bandwidth,否則不返回。

export_location

String

SFS Turbo文件系統(tǒng)的掛載端點(diǎn)。

id

String

SFS Turbo的文件系統(tǒng)ID。

name

String

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

pay_model

String

SFS Turbo文件系統(tǒng)的計費(fèi)模式。'0'代表按需付費(fèi),'1'代表包周期計費(fèi)。

枚舉值:

  • 0

  • 1

region

String

SFS Turbo文件系統(tǒng)所在區(qū)域。

security_group_id

String

用戶指定的安全組ID。

share_proto

String

SFS Turbo文件系統(tǒng)的協(xié)議類型,當(dāng)前為NFS

share_type

String

SFS Turbo文件系統(tǒng)性能類型,包括“STANDARD”標(biāo)準(zhǔn)型和“PERFORMANCE”性能型。

size

String

SFS Turbo文件系統(tǒng)總?cè)萘?,單位GB。

status

String

SFS Turbo文件系統(tǒng)的狀態(tài)。'100'表示創(chuàng)建中,'200'表示可用,'303'表示創(chuàng)建失敗,'800'表示實(shí)例被凍結(jié)。

sub_status

String

SFS Turbo文件系統(tǒng)的子狀態(tài)。 '121'表示擴(kuò)容中;'132'表示修改安全組中;'137'表示添加VPC中;'138'表示刪除VPC中;'150'表示配置聯(lián)動后端中;'151'表示刪除聯(lián)動后端配置中; '221'表示擴(kuò)容成功;'232'表示修改安全組成功;'237'表示添加VPC成功;'238'表示刪除VPC成功;'250'表示配置聯(lián)動后端成功;'251'表示刪除聯(lián)動后端配置成功; '321'表示擴(kuò)容失敗;'332'表示修改安全組失??;'337'表示添加VPC失??;'338'表示刪除VPC失??;'350'表示配置聯(lián)動后端失敗;'351'表示刪除聯(lián)動后端配置失??;

subnet_id

String

用戶指定的子網(wǎng)的網(wǎng)絡(luò)ID。

vpc_id

String

用戶指定的VPC ID。

表6 ActionProgress

參數(shù)

參數(shù)類型

描述

CREATING

String

創(chuàng)建文件系統(tǒng)的進(jìn)度。

請求示例

響應(yīng)示例

狀態(tài)碼: 200

查詢列表成功,返回body

{
  "shares" : [ {
    "id" : "8fba8253-c914-439d-ae8b-d5c89d0bf5e8",
    "name" : "sfs-turbo-8468",
    "status" : "100",
    "version" : "1.0.0",
    "region" : "north-1",
    "created_at" : "2018-11-19T04:02:03",
    "export_location" : "192.168.0.90:/",
    "action_progress" : {
      "CREATING" : "22%"
    },
    "share_type" : "STANDARD",
    "sub_status" : "",
    "availability_zone" : "az1.dc1",
    "az_name" : "az1",
    "vpc_id" : "b24e39e1-bc0c-475b-ae0c-aef9cf240af3",
    "subnet_id" : "86fc01ea-8ec8-409d-ba7a-e0ea16d4fd97",
    "security_group_id" : "50586458-aec9-442c-bb13-e08ddc6f1b7a",
    "size" : "500.00",
    "pay_model" : "0",
    "avail_capacity" : "500.00",
    "share_proto" : "NFS"
  }, {
    "id" : "65f2d30b-7b4e-4786-9608-4324faef6646",
    "name" : "sfs-turbo-df12",
    "status" : "200",
    "version" : "1.0.0",
    "region" : "north-1",
    "created_at" : "2018-11-15T02:32:10",
    "export_location" : "192.168.0.197:/",
    "share_type" : "STANDARD",
    "sub_status" : "",
    "availability_zone" : "az1.dc1",
    "az_name" : "az1",
    "vpc_id" : "b24e39e1-bc0c-475b-ae0c-aef9cf240af3",
    "subnet_id" : "86fc01ea-8ec8-409d-ba7a-e0ea16d4fd97",
    "security_group_id" : "50586458-aec9-442c-bb13-e08ddc6f1b7a",
    "size" : "500.00",
    "pay_model" : "0",
    "avail_capacity" : "500.00",
    "share_proto" : "NFS"
  } ]
}

狀態(tài)碼

狀態(tài)碼

描述

200

查詢列表成功,返回body

錯誤碼

請參見錯誤碼。