
# 获取sfs-turbo资源列表 - ListSfsTurbos
#### 功能介绍
获取sfs-turbo资源列表。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0100.html)。
#### URI
GET /v1/{project_id}/system/sfs-turbos
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**： 项目ID，您可以从[获取项目ID](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0033.html)中获取。 **约束限制**： 不涉及 **取值范围**： 仅支持字母、数字、中划线和下划线，长度为\[1-128\]个字符。 **默认取值**： 不涉及 |
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                                                                                                     |
|:---|:---|:---|:---|
| limit  | 否    | Integer | **参数解释**： 限制量，单次查询总量，必须由数字组成，默认为100，取值范围\[1,1000\]。 **约束限制**： 不涉及 **取值范围**： 1-1000 **默认取值**： 100       |
| offset | 否    | Integer | **参数解释**： 偏移量，查询起始偏移，必须由数字组成，默认为0，取值范围\[0,100000000\]。 **约束限制**： 不涉及 **取值范围**： 0-100000000 **默认取值**： 0 |
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释**： 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，[获取Token](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0011.html)接口响应消息头中X-Subject-Token的值即为Token。 **约束限制**： 不涉及 **取值范围**： 长度为\[1-32768\]个字符。 **默认取值**： 不涉及 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数         | 参数类型                                                                 | 描述                                                                 |
|:---|:---|:---|
| sfs_turbos | Array of [SfsTurboRsp] objects | **参数解释**： sfs-turbo资源列表。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 |
| count      | Integer                                                              | **参数解释**： sfs-turbo资源总数。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 |
   
 表5SfsTurboRsp 
| 参数     | 参数类型   | 描述                                                                                                                                                     |
|:---|:---|:---|
| id     | String | **参数解释**： sfs-turbo资源ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                                                                     |
| name   | String | **参数解释**： sfs-turbo资源名称。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                                                                     |
| status | String | **参数解释**： sfs-turbo资源状态。 **约束限制**： 不涉及 **取值范围**： - CREATING: 创建中 - ACTIVE：可用 - FAILED：失败 - CREATE_FAILED：创建失败 - DELETED：已删除 - FROZEN：已冻结 **默认取值**： 不涉及 |
| type   | String | **参数解释**： sfs-turbo资源类型。 **约束限制**： 不涉及 **取值范围**： - STANDARD：标准 **默认取值**： 不涉及                                                                           |
| space  | String | **参数解释**： sfs-turbo资源容量，单位GB。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                                                                                |
   
#### 请求示例
获取sfs-turbo列表，查询起始偏移为0，单次查询总量为10。
```
https://{endpoint}/v1/{project_id}/system/sfs-turbos?imit=10&offset=0
```
#### 响应示例
**状态码：200**
OK
```
{
  "count" : 1,
  "sfs_turbos" : [ {
    "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1",
    "name" : "sfs-turbo-e1d5",
    "status" : "Available"
  } ]
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ai4sservice/ErrorCode.html)。
