调试
您可以在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文件系统实例。 获取方法请参见查询文件系统列表接口。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
表3 请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 |
| action | 是 | String | 参数解释: 操作类型,用于指定要更新的冷数据时间配置项。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| gc_time | 否 | Integer | 参数解释: 冷数据淘汰时间,单位为小时。 表示文件系统中数据自上次访问后,经过该时长未被再次访问的冷数据将被淘汰清理。 约束限制: 当action为config_gc_time时必填。 取值范围: 1~100000000的整数。 默认取值: 60 |
| ck_time | 否 | Integer | 参数解释: 冷数据校验时间,单位为小时。 表示文件系统中数据自上次访问后,经过该时长未被再次访问将被标记为冷数据并触发校验。 约束限制: 当action为config_ck_time时必填。 取值范围: 1~100000000的整数。 默认取值: 不涉及。 |
响应参数
状态码:200
表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 | 错误响应 |