文档首页/ 弹性文件服务 SFS/ API参考/ SFS Turbo API说明/ 生命周期管理/ 查询文件系统详细信息
更新时间：2025-07-22 GMT+08:00
查看PDF
分享

查询文件系统详细信息

功能介绍

查询SFS Turbo文件系统详细信息。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

share_id

是

String

文件系统ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

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

Datetime

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

crypt_key_id

String

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

expand_type

String

如果是增强版文件系统，该字段返回bandwidth；如果是20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB，该字段返回hpc；否则不返回。

export_location

String

SFS Turbo文件系统的挂载端点。例如"192.168.0.90:/"。如果文件系统正在创建，该字段不返回。

id

String

SFS Turbo的文件系统ID。

name

String

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

pay_model

String

SFS Turbo文件系统的计费模式。'0'代表按需付费。如果文件系统正在创建，该字段不返回。

枚举值：

  • 0

  • 1

region

String

SFS Turbo文件系统所在区域。

security_group_id

String

用户指定的安全组ID。

share_proto

String

SFS Turbo文件系统的协议类型，当前为NFS或 CIFS。

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。

enterprise_project_id

String

SFS Turbo文件系统绑定的企业项目ID。

tags

Array of ResourceTag objects

tag标签的列表。

optional_endpoint

String

可选的挂载IP地址。上一代文件系统规格类型不返回该字段。

hpc_bw

String

文件系统的带宽规格。

  • "20M"表示20MB/s/TiB

  • "40M"表示40MB/s/TiB

  • "125M"表示125MB/s/TiB

  • "250M"表示250MB/s/TiB

  • "500M"表示500MB/s/TiB

  • "1000M"表示1000MB/s/TiB

instanceId

String

文件系统规格的节点id，为预留字段，不具备实际含义。

instanceType

String

文件系统规格的节点类型，为预留字段，不具备实际含义。

statusDetail

String

文件系统的请求ID，为预留字段，不具备实际含义。

features

ShareInfoFeatures object

文件系统的特性支持情况。
表4 ActionProgress

参数

参数类型

描述

CREATING

String

创建文件系统的进度。
表5 ResourceTag

参数

参数类型

描述

key

String

标签的键。

最大长度128个字符。

key不能为空，不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字，特殊字符"-"和"_"。

value

String

标签的值。

每个值最大长度255个字符，可以为空字符串。

不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字，特殊字符"-"和"_"。
表6 ShareInfoFeatures

参数

参数类型

描述

backup

ShareInfoFeature object

SFS Turbo文件系统是否支持备份。
表7 ShareInfoFeature

参数

参数类型

描述

is_support

Boolean

文件系统是否支持该特性

message

String

文件系统是否支持该特性的详细信息

msg_code

String

文件系统是否支持该特性的详细信息

请求示例

查询ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"的文件系统详细信息

GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde

响应示例

状态码：200

查询文件系统返回body

  • 查询项目ID为“e1e45b08f3ea4480ab4655ef9c7160ba”的文件系统列表的响应示例。

    {
  "id" : "8fba8253-c914-439d-ae8b-d5c89d0bf5e8",
  "name" : "sfs-turbo-8468",
  "status" : "200",
  "version" : "1.0.0",
  "region" : "example",
  "availability_zone" : "example",
  "az_name" : "example",
  "created_at" : "2018-11-19T04:02:03",
  "export_location" : "192.168.xx.xx:/",
  "action_progress" : { },
  "share_type" : "STANDARD",
  "sub_status" : "221",
  "vpc_id" : "b24e39e1-bc0c-475b-ae0c-aef9cf240af3",
  "subnet_id" : "86fc01ea-8ec8-409d-ba7a-e0ea16d4fd97",
  "security_group_id" : "50586458-aec9-442c-bb13-e08ddc6f1b7a",
  "size" : "600.00",
  "avail_capacity" : "600.00",
  "pay_model" : "0",
  "share_proto" : "NFS"
}

状态码

状态码

描述

200

查询文件系统返回body

错误码

请参见错误码。

父主题： 生命周期管理