更新文件系统淘汰策略 - UpdateTargetEvictionStrategies
功能介绍
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
PUT /v1/{project_id}/sfs-turbo/shares/{share_id}/target-eviction-strategies
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID。 |
| share_id | 是 | String | 文件系统ID。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 账号的token。 |
| Content-Type | 是 | String | MIME类型。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| type | 是 | String | 参数解释 淘汰策略类型。 约束限制 不涉及。 取值范围 默认取值 不涉及。 |
| eviction_strategy | 是 | EvictionStrategy object | 参数解释 文件系统淘汰策略。 约束限制 不涉及。 取值范围 不涉及。 默认取值 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| capacity_usage_watermark | 否 | CapacityUsageWatermark object | 参数解释 容量使用率水位。 约束限制 该参数仅支持按容量淘汰,即type为“capacity”。 取值范围 不涉及。 默认取值 不涉及。 |
| duration_since_last_access | 否 | Integer | 参数解释 数据距上次访问的时长,单位:分钟。 约束限制 不涉及。 取值范围 按容量淘汰时,取值范围是[11,6000000000]。 按时间淘汰时,取值范围是[60,6000000000],同时必须是60的倍数。 默认取值 按容量淘汰时,默认值是30,表示30分钟内没有被访问过的数据即为冷数据。 按时间淘汰时,默认值是3600,表示3600分钟内没有被访问过的数据即为冷数据。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| X-request-id | String | 请求ID |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| type | String | 参数解释 淘汰策略类型。 取值范围 |
| eviction_strategy | EvictionStrategy object | 参数解释 文件系统淘汰策略。 取值范围 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| capacity_usage_watermark | CapacityUsageWatermark object | 参数解释 容量使用率水位。 取值范围 不涉及。 |
| duration_since_last_access | Integer | 参数解释 数据距上次访问的时长,单位:分钟。 取值范围 按容量淘汰时,取值范围是[11,6000000000]。 按时间淘汰时,取值范围是[60,6000000000],同时必须是60的倍数。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| high | Integer | 参数解释 容量使用率上水位,SFS Turbo文件系统的容量使用率到达上水位即会开始淘汰冷数据。 取值范围 [0,101] |
| low | Integer | 参数解释 容量使用率下水位,触发淘汰后会将SFS Turbo文件系统的容量使用率清理到下水位。 取值范围 [0,100]。下水位必须小于上水位。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| errCode | String | 错误码 |
| errMsg | String | 错误描述 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| errCode | String | 错误码 |
| errMsg | String | 错误描述 |
请求示例
响应示例
状态码:200
成功
-
{ "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 | 错误响应 |
错误码
请参见错误码。