# 查询文件系统淘汰策略 - ListTargetEvictionStrategies
#### 功能介绍
SFS Turbo文件系统绑定后端存储后，数据淘汰默认开启。SFS Turbo文件系统数据支持按容量淘汰或按时间淘汰。
#### 接口约束
- 该接口仅支持已绑定后端存储的文件系统。
  
- 该接口仅适用于100MB/s/TiB-智算型、200MB/s/TiB-智算型文件系统。
- 该接口仅适用于NFS文件系统共享协议。
  
 
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=ListTargetEvictionStrategies)中调试该接口，支持自动认证鉴权。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/shares/{share_id}/target-eviction-strategies
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID。   |
| share_id   | 是    | String | 文件系统ID。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述        |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 账号的token。 |
| Content-Type | 是    | String | MIME类型。   |
   
#### 响应参数
**状态码：200**
表3响应Header参数 
| 参数           | 参数类型   | 描述   |
|:---|:---|:---|
| X-request-id | String | 请求ID |
   
表4响应Body参数 
| 参数                  | 参数类型                                                                                                        | 描述                                                                                                                                                                           |
|:---|:---|:---|
| eviction_strategies | Array of [EvictionStrategyContent] objects | **参数解释** 淘汰策略。 **取值范围** 不涉及。 |
   
 表5EvictionStrategyContent 
| 参数                | 参数类型                                                                                | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|
| type              | String                                                                              | **参数解释** 淘汰策略类型。 **取值范围** - capacity：表示按容量淘汰。   - time：表示按时间淘汰。    |
| eviction_strategy | [EvictionStrategy] object | 文件系统淘汰策略。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   
 表6EvictionStrategy 
| 参数                         | 参数类型                                                                                            | 描述                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|
| capacity_usage_watermark   | [CapacityUsageWatermark] object | **参数解释** 容量使用率水位。 **取值范围** 不涉及。                                                                                                                              |
| duration_since_last_access | Integer                                                                                         | **参数解释** 数据距上次访问的时长，单位：分钟。 **取值范围** 按容量淘汰时，取值范围是\[11,6000000000\]。 按时间淘汰时，取值范围是\[60,6000000000\]，同时必须是60的倍数。 |
   
 表7CapacityUsageWatermark 
| 参数   | 参数类型    | 描述                                                                                                                                                                                                                                 |
|:---|:---|:---|
| high | Integer | **参数解释** 容量使用率上水位，SFS Turbo文件系统的容量使用率到达上水位即会开始淘汰冷数据。 **取值范围** \[0,101\]            |
| low  | Integer | **参数解释** 容量使用率下水位，触发淘汰后会将SFS Turbo文件系统的容量使用率清理到下水位。 **取值范围** \[0,100\]。下水位必须小于上水位。 |
   
**状态码：400**
表8响应Body参数 
| 参数      | 参数类型   | 描述   |
|:---|:---|:---|
| errCode | String | 错误码  |
| errMsg  | String | 错误描述 |
   
**状态码：500**
表9响应Body参数 
| 参数      | 参数类型   | 描述   |
|:---|:---|:---|
| errCode | String | 错误码  |
| errMsg  | String | 错误描述 |
   
#### 请求示例
无
#### 响应示例
**状态码：200**
成功
```
{
  "eviction_strategies" : [ {
    "type" : "capacity",
    "eviction_strategy" : {
      "duration_since_last_access" : 30,
      "capacity_usage_watermark" : {
        "high" : 95,
        "low" : 85
      }
    }
  }, {
    "type" : "time",
    "eviction_strategy" : {
      "duration_since_last_access" : 3600
    }
  } ]
}
```
**状态码：400**
错误响应
```
{
  "errCode" : "SFS.TURBO.0001",
  "errMsg" : "parameter error"
}
```
**状态码：500**
错误响应
```
{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}
```
#### 状态码
| 状态码 | 描述   |
|:---|:---|
| 200 | 成功   |
| 400 | 错误响应 |
| 500 | 错误响应 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。