查询文件系统淘汰策略 - ListTargetEvictionStrategies_存储联动管理_API_API参考

功能介绍

SFS Turbo文件系统绑定后端存储后，数据淘汰默认开启。SFS Turbo文件系统数据支持按容量淘汰或按时间淘汰。

接口约束

该接口仅支持已绑定后端存储的文件系统。
该接口仅适用于100MB/s/TiB-智算型、200MB/s/TiB-智算型文件系统。
该接口仅适用于NFS文件系统共享协议。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

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	参数解释淘汰策略。取值范围不涉及。

表5 EvictionStrategyContent
参数	参数类型	描述
type	String	参数解释淘汰策略类型。取值范围 capacity：表示按容量淘汰。 time：表示按时间淘汰。
eviction_strategy	EvictionStrategy object	文件系统淘汰策略。

表6 EvictionStrategy
参数	参数类型	描述
capacity_usage_watermark	CapacityUsageWatermark object	参数解释容量使用率水位。取值范围不涉及。
duration_since_last_access	Integer	参数解释数据距上次访问的时长，单位：分钟。取值范围按容量淘汰时，取值范围是[11,6000000000]。按时间淘汰时，取值范围是[60,6000000000]，同时必须是60的倍数。

表7 CapacityUsageWatermark
参数	参数类型	描述
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	错误响应

错误码

请参见错误码。

查询文件系统淘汰策略 - ListTargetEvictionStrategies