华为云计算 云知识 获取文件系统列表ListShares
获取文件系统列表ListShares

 

功能介绍

获取文件系统列表

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

操作用户的项目ID。

表2 Query参数

参数

是否必选

参数类型

描述

limit

Long

返回的文件系统个数,最大值为200。

最小值:0

最大值:200

offset

Long

文件系统查询个数的偏移量。

最小值:0

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

帐号的token

Content-Type

String

MIME类型

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

shares

Array of ShareInfo objects

SFS Turbo文件系统的列表。

count

Integer

SFS Turbo文件系统的数量。

表5 ShareInfo

参数

参数类型

描述

action_progress

ActionProgress object

SFS Turbo文件系统的任务进度。例如创建文件系统进度。

version

String

SFS Turbo文件系统的版本号。

avail_capacity

String

SFS Turbo文件系统剩余容量,单位GB。

availability_zone

String

SFS Turbo文件系统所在可用区编码。

az_name

String

SFS Turbo文件系统所在可用区名称。

created_at

String

创建时间。UTC时间,例如:2018-11-19T04:02:03

crypt_key_id

String

用户指定的加密密钥ID,非加密盘时不返回。

expand_type

String

如果是增强型文件系统,该字段返回bandwidth,否则不返回。

export_location

String

SFS Turbo文件系统的挂载端点。

id

String

SFS Turbo的文件系统ID。

name

String

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

pay_model

String

SFS Turbo文件系统的计费模式。'0'代表按需付费,'1'代表包周期计费。

枚举值:

  • 0

  • 1

region

String

SFS Turbo文件系统所在区域。

security_group_id

String

用户指定的安全组ID。

share_proto

String

SFS Turbo文件系统的协议类型,当前为NFS

share_type

String

SFS Turbo文件系统性能类型,包括“STANDARD”标准型和“PERFORMANCE”性能型。

size

String

SFS Turbo文件系统总容量,单位GB。

status

String

SFS Turbo文件系统的状态。'100'表示创建中,'200'表示可用,'303'表示创建失败,'800'表示实例被冻结。

sub_status

String

SFS Turbo文件系统的子状态。 '121'表示扩容中;'132'表示修改安全组中;'137'表示添加VPC中;'138'表示删除VPC中;'150'表示配置联动后端中;'151'表示删除联动后端配置中; '221'表示扩容成功;'232'表示修改安全组成功;'237'表示添加VPC成功;'238'表示删除VPC成功;'250'表示配置联动后端成功;'251'表示删除联动后端配置成功; '321'表示扩容失败;'332'表示修改安全组失败;'337'表示添加VPC失败;'338'表示删除VPC失败;'350'表示配置联动后端失败;'351'表示删除联动后端配置失败;

subnet_id

String

用户指定的子网的网络ID。

vpc_id

String

用户指定的VPC ID。

表6 ActionProgress

参数

参数类型

描述

CREATING

String

创建文件系统的进度。

请求示例

响应示例

状态码: 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"
  } ]
}

状态码

状态码

描述

200

查询列表成功,返回body

错误码

请参见错误码

 

上一篇:云享读书会《数据仓库工具箱》 下一篇:云备份:VMware备份上云

弹性文件服务 SFS 

 

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