链接复制成功!
查询文件系统类型和配额 - ListShareTypes
功能介绍
查询文件系统类型、文件系统类型的配额、可用区列表等。当前只在部分区域支持。具体的区域列表请参见API概览的接口说明。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
GET /v1/{project_id}/sfs-turbo/share-types
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| limit | 否 | Integer | 查询文件系统类型和配额返回的个数最大值 |
| offset | 否 | Integer | 查询文件系统类型和配额返回的偏移量 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 账号的token |
| Content-Type | 是 | String | MIME类型 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| X-request-id | String | 请求ID |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| share_types | Array of ShareTypeResponseBody objects | 文件系统类型和配额列表 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| share_type | String | 文件系统类型。 枚举值: |
| scenario | String | 文件系统场景 |
| attribution | ShareTypesAttribution object | 文件系统属性 |
| support_period | Boolean | 是否支持包周期 |
| available_zones | Array of ShareTypeAvailableZone objects | 可用区 |
| spec_code | String | 文件系统规格编码 |
| storage_media | String | 存储类型 枚举值: |
| features | Array of strings | 文件系统类型支持的特性列表。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| capacity | 容量属性 | |
| bandwidth | 带宽属性 | |
| iops | ShareTypesAttributionIops object | IOPS属性 |
| single_channel_4k_latency | 平均单路4K延迟属性 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| max | Integer | 最大带宽 |
| min | Integer | 最小带宽 |
| step | Integer | 带宽梯度 |
| density | Number | 带宽密度 |
| base | Integer | 基础带宽 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| X-request-id | String | 请求ID |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 错误响应 |
错误码
请参见错误码。