# 查询文件系统类型和配额 - ListShareTypes #### 功能介绍 查询文件系统类型、文件系统类型的配额、可用区列表等。当前只在部分区域支持。具体的区域列表请参见[API概览](https://support.huaweicloud.com/api-sfsturbo/sfsturbo_02_0007.html)的接口说明。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=ListShareTypes)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfsturbo/sfsturbo_02_0079.html)。 #### URI GET /v1/{project_id}/sfs-turbo/share-types 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 文件系统类型和配额列表 | 表6ShareTypeResponseBody | 参数 | 参数类型 | 描述 | |:---|:---|:---| | share_type | String | 文件系统类型。 枚举值： - standard：表示标准型。 - standard.enhanced：表示标准型-增强版。 - performance：表示性能型。 - performance.enhanced：表示性能型-增强版。 - hpc.20M：表示20 MB/s/TiB。 - hpc.40M：表示40 MB/s/TiB。 - hpc.125M：表示125 MB/s/TiB。 - hpc.250M：表示250 MB/s/TiB。 - hpc.500M：表示500 MB/s/TiB。 - hpc.1000M：表示1000 MB/s/TiB。 - hpc.cache：表示hpc缓存型。 | | 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 | 文件系统类型支持的特性列表。 | 表7ShareTypesAttribution | 参数 | 参数类型 | 描述 | |:---|:---|:---| | capacity | [ShareTypesAttributionCapacity] object | 容量属性 | | bandwidth | [ShareTypesAttributionBandwidth] object | 带宽属性 | | iops | [ShareTypesAttributionIops] object | IOPS属性 | | single_channel_4k_latency | [ShareTypesAttributionSingleChannel4KLatency] object | 平均单路4K延迟属性 | 表8ShareTypesAttributionCapacity | 参数 | 参数类型 | 描述 | |:---|:---|:---| | max | Integer | 最大容量 | | min | Integer | 最小容量 | | step | Number | 容量梯度 | 表9ShareTypesAttributionBandwidth | 参数 | 参数类型 | 描述 | |:---|:---|:---| | max | Integer | 最大带宽 | | min | Integer | 最小带宽 | | step | Integer | 带宽梯度 | | density | Number | 带宽密度 | | base | Integer | 基础带宽 | 表10ShareTypesAttributionIops | 参数 | 参数类型 | 描述 | |:---|:---|:---| | max | Integer | 最大IOPS | | min | Integer | 最小IOPS | 表11ShareTypesAttributionSingleChannel4KLatency | 参数 | 参数类型 | 描述 | |:---|:---|:---| | max | Integer | 最大值 | | min | Integer | 最小值 | 表12ShareTypeAvailableZone | 参数 | 参数类型 | 描述 | |:---|:---|:---| | available_zone | String | 可用区 | | status | String | 在可用区的状态 枚举值： - **normal** - **sellout** | **状态码：400** 表13响应Header参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | X-request-id | String | 请求ID | 表14响应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" : "HDD", "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" : "HDD", "support_period" : true, "available_zones" : [ { "available_zone" : "az1", "status" : "normal" } ], "features" : [ "periodic" ] } ] } ``` **状态码：400** 错误响应 ``` { "errCode" : "SFS.TURBO.0001", "errMsg" : "parameter error" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 成功 | | 400 | 错误响应 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。