文档首页/ 高性能弹性文件服务 SFS Turbo/ API参考/ API/ 存储联动管理/ 更新文件系统冷数据淘汰时间 - UpdateHpcShare
更新时间:2026-09-30 GMT+08:00
分享

更新文件系统冷数据淘汰时间 - UpdateHpcShare

功能介绍

更新文件系统冷数据淘汰时间。

接口约束

  • 该接口仅支持已绑定后端存储的文件系统。

  • 该接口仅适用于SFS Turbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、100MB/s/TiB-智算型、200MB/s/TiB-智算型文件系统。

  • 该接口仅适用于NFS文件系统共享协议。

调试

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

授权信息

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

URI

PUT /v1/{project_id}/sfs-turbo/shares/{share_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,用于标识资源所属的IAM项目空间,实现项目级资源隔离与权限管控。

获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

share_id

是

String

参数解释:

文件系统ID,用于唯一标识SFS Turbo文件系统实例。

获取方法请参见查询文件系统列表接口。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token,用于鉴权认证。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

Content-Type

是

String

参数解释:

请求消息体MIME类型,用于标识请求正文的数据格式。

约束限制:

不涉及。

取值范围:

application/json

默认取值:

application/json

表3 请求Body参数

参数

是否必选

参数类型

描述

action

是

String

参数解释:

操作类型,用于指定要更新的冷数据时间配置项。

约束限制:

不涉及。

取值范围:

  • config_gc_time:配置冷数据淘汰时间,需同时传入gc_time参数。

  • config_ck_time:配置冷数据校验时间,需同时传入ck_time参数。

默认取值:

不涉及。

gc_time

否

Integer

参数解释:

冷数据淘汰时间,单位为小时。

表示文件系统中数据自上次访问后,经过该时长未被再次访问的冷数据将被淘汰清理。

约束限制:

当action为config_gc_time时必填。

取值范围:

1~100000000的整数。

默认取值:

60

ck_time

否

Integer

参数解释:

冷数据校验时间,单位为小时。

表示文件系统中数据自上次访问后,经过该时长未被再次访问将被标记为冷数据并触发校验。

约束限制:

当action为config_ck_time时必填。

取值范围:

1~100000000的整数。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Header参数

参数

参数类型

描述

X-request-id

String

参数解释:

请求ID,用于唯一标识和追踪本次请求。

取值范围:

不涉及。

表5 响应Body参数

参数

参数类型

描述

gc_time

Integer

参数解释:

冷数据淘汰时间,单位为小时。

当请求action为config_gc_time时返回该字段。

取值范围:

1~100000000的整数。

ck_time

Integer

参数解释:

冷数据校验时间,单位为小时。

当请求action为config_ck_time时返回该字段。

取值范围:

1~100000000的整数。

状态码:404

表6 响应Body参数

参数

参数类型

描述

errCode

String

参数解释:

错误码,用于标识请求失败的原因。详细错误码请参见错误码。

取值范围:

不涉及。

errMsg

String

参数解释:

错误描述,用于描述请求失败的具体原因,便于排查问题。请参见错误码。

取值范围:

不涉及。

状态码:500

表7 响应Body参数

参数

参数类型

描述

errCode

String

参数解释:

错误码,用于标识请求失败的原因。详细错误码请参见错误码。

取值范围:

不涉及。

errMsg

String

参数解释:

错误描述,用于描述请求失败的具体原因,便于排查问题。请参见错误码。

取值范围:

不涉及。

请求示例

更新文件系统冷数据淘汰时间

{
  "action" : "config_gc_time",
  "gc_time" : 5
}

响应示例

状态码:200

{
  "gc_time" : 10
}

状态码:404

{
  "errCode" : "SFS.TURBO.0002",
  "errMsg" : "share not exist"
}

状态码:500

{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}

状态码

状态码

描述

200

任务下发成功

404

错误响应

500

错误响应

错误码

请参见错误码。

相关文档