文档首页/ 弹性文件服务 SFS/ API参考/ SFS Turbo API说明/ 查询文件系统类型和配额/ 查询文件系统类型和配额
更新时间：2025-06-05 GMT+08:00
查看PDF
分享

查询文件系统类型和配额

功能介绍

查询文件系统类型和配额

调试

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

URI

GET /v1/{project_id}/sfs-turbo/share-types

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

查询文件系统类型和配额返回的个数最大值

offset

否

Integer

查询文件系统类型和配额返回的偏移量

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型

响应参数

状态码：200

表4 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表5 响应Body参数

参数

参数类型

描述

share_types

Array of ShareTypeResponseBody objects

文件系统类型和配额列表
表6 ShareTypeResponseBody

参数

参数类型

描述

share_type

String

文件系统类型

scenario

String

文件系统场景

attribution

ShareTypesAttribution object

文件系统属性

support_period

Boolean

是否支持包周期

available_zones

Array of ShareTypeAvailableZone objects

可用区

spec_code

String

文件系统规格编码

storage_media

String

存储类型

枚举值：

  • HDD

  • SSD

  • ESSD

features

Array of strings

实例支持的特性列表
表7 ShareTypesAttribution

参数

参数类型

描述

capacity

ShareTypesAttributionCapacity object

容量属性

bandwidth

ShareTypesAttributionBandwidth object

带宽属性

iops

ShareTypesAttributionIops object

iops属性

single_channel_4k_latency

ShareTypesAttributionSingleChannel4KLatency object

平均单路4K延迟属性
表8 ShareTypesAttributionCapacity

参数

参数类型

描述

max

Integer

最大容量

min

Integer

最小容量

step

Number

容量梯度
表9 ShareTypesAttributionBandwidth

参数

参数类型

描述

max

Integer

最大带宽

min

Integer

最小带宽

step

Integer

带宽梯度

density

Number

带宽密度

base

Integer

基础带宽
表10 ShareTypesAttributionIops

参数

参数类型

描述

max

Integer

最大iops

min

Integer

最小iops
表11 ShareTypesAttributionSingleChannel4KLatency

参数

参数类型

描述

max

Integer

最大值

min

Integer

最小值
表12 ShareTypeUsage

参数

参数类型

描述

capacity

ShareTypeUsageCapacity object

文件系统容量

bandwidth

ShareTypeUsageBandwidth object

文件系统带宽

quantity

ShareTypeUsageQuantity object

文件系统数目
表13 ShareTypeUsageCapacity

参数

参数类型

描述

total

Integer

总容量

usage

Integer

已用容量
表14 ShareTypeUsageBandwidth

参数

参数类型

描述

total

Integer

总带宽

usage

Integer

已用带宽
表15 ShareTypeUsageQuantity

参数

参数类型

描述

total

Integer

总文件系统数量

usage

Integer

文件系统已用数量
表16 ShareTypeAvailableZone

参数

参数类型

描述

available_zone

String

可用区

status

String

在可用区的状态

枚举值：

  • normal

  • sellout

状态码：400

表17 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表18 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

请求示例

无

响应示例

状态码：200

成功

  • 查询当前所支持的文件系统类型和配额。

    {
  "share_types" : [ {
    "share_type" : "standard",
    "scenario" : "Standard",
    "attribution" : {
      "capacity" : {
        "max" : 1048576,
        "min" : 100,
        "step" : 100
      },
      "bandwidth" : {
        "max" : 300,
        "min" : 150,
        "step" : -1,
        "density" : 40.96,
        "base" : 150
      },
      "iops" : {
        "max" : 20000,
        "min" : 1000
      },
      "single_channel_4k_latency" : {
        "max" : 20000,
        "min" : 1000
      }
    },
    "spec_code" : "sfs.turbo.standard",
    "storage_media" : "SATA",
    "support_period" : true,
    "available_zones" : [ {
      "available_zone" : "az1",
      "status" : "normal"
    } ],
    "features" : [ "periodic" ]
  }, {
    "share_type" : "hpc.125M",
    "scenario" : "Standard",
    "attribution" : {
      "capacity" : {
        "max" : 1048576,
        "min" : 512,
        "step" : 1228.8
      },
      "bandwidth" : {
        "max" : 20480,
        "min" : 150,
        "step" : -1,
        "density" : 125,
        "base" : 0
      },
      "iops" : {
        "max" : 1000000,
        "min" : 0
      },
      "single_channel_4k_latency" : {
        "max" : 3,
        "min" : 1
      }
    },
    "spec_code" : "sfs.turbo.standard",
    "storage_media" : "SATA",
    "support_period" : true,
    "available_zones" : [ {
      "available_zone" : "az1",
      "status" : "normal"
    } ],
    "features" : [ "periodic" ]
  } ]
}

状态码：400

错误响应

{
  "errCode" : "SFS.TURBO.0001",
  "errMsg" : "parameter error"
}

状态码

状态码

描述

200

成功

400

错误响应

错误码

请参见错误码。

相关文档