文件系统管理-华为云

高性能弹性文件服务 SFS TURBO-创建文件系统:前提条件

前提条件创建SFS Turbo文件系统前，确认已有可用的VPC。如果无VPC，可参考《虚拟私有云用户指南》中的“创建虚拟私有云基本信息及默认子网”章节创建VPC。创建SFS Turbo文件系统前，确认已有可用的E CS ，且ECS归属到已创建的VPC下。如果无ECS，可参考《弹性云服务器快速入门》中的“购买弹性云服务器”章节购买ECS。创建SFS Turbo文件系统，依赖的服务有：虚拟私有云 VPC、费用中心 BSS、专属存储服务 DSS和弹性云服务器 ECS。需要配置的角色/策略如下： IAM 用户设置了SFS Turbo FullAccess权限后，权限集中包含了VPC FullAccess，这是创建文件系统所需要的权限，用户不需额外添加VPC FullAccess 系统策略。如果需要创建包年包月文件系统，需要设置BSS Administrator权限。如果需要在专属项目下创建文件系统，需要设置DSS FullAccess 和 ECS FullAccess权限。

高性能弹性文件服务 SFS TURBO 文件系统管理

弹性文件服务 SFS-配置hpc缓存型后端信息:请求示例

请求示例配置hpc缓存型后端信息，冷数据淘汰时间是100小时，后端校验时间是60秒。配置obs后端信息，obs桶的终端节点是“obs.cn-north-7.ulanqab.example.com”，obs桶名是“mubucket”。 { "update_hpc_cache" : { "action" : "initialize_overlay", "data" : { "gc_time" : 100, "ck_time" : 60, "obs" : [ { "name" : "abc", "type" : "OBS", "url" : "obs.cn-north-7.ulanqab.example.com", "bucket" : "mubucket" } ] } } }

弹性文件服务 SFS 文件系统管理

弹性文件服务 SFS-配置hpc缓存型后端信息:响应参数

响应参数状态码： 200 表8 响应Header参数参数参数类型描述 X-request-id String 请求ID 状态码： 400 表9 响应Header参数参数参数类型描述 X-request-id String 请求ID 表10 响应Body参数参数参数类型描述 errCode String 错误码最小长度：8 最大长度：36 errMsg String 错误描述最小长度：2 最大长度：512 状态码： 500 表11 响应Header参数参数参数类型描述 X-request-id String 请求ID 表12 响应Body参数参数参数类型描述 errCode String 错误码最小长度：8 最大长度：36 errMsg String 错误描述最小长度：2 最大长度：512

弹性文件服务 SFS 文件系统管理

弹性文件服务 SFS-配置hpc缓存型后端信息:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 账号的token Content-Type 是 String MIME类型表3 请求Body参数参数是否必选参数类型描述 update_hpc_cache 是 ReqUpdateHpcCacheInfo object 后端挂载信息表4 ReqUpdateHpcCacheInfo 参数是否必选参数类型描述 action 是 String 配置hpc缓存型的动作，如initialize_overlay data 是 ReqUpdateHpcCacheData object hpc 缓存型后端配置信息表5 ReqUpdateHpcCacheData 参数是否必选参数类型描述 gc_time 是 Long 冷数据淘汰时间。单位：小时。指定时间内线上缓存的数据如果没有被访问则会自动从缓存中删除。0表示数据不会因为时间原因自动从缓存中删除。 ck_time 是 Long 后端校验时间。单位：秒。指定时间间隔进行线上缓存文件与后端存储文件比较，存在变化则自动更新。0表示文件进行实时校验。 nas 否 Array of ConfigNasTarget objects 配置 nas 后端的信息, 和 obs 字段为二选一的关系 obs 否 Array of ConfigObsTarget objects 配置 obs 后端的信息, 和 nas 字段为二选一的关系表6 ConfigNasTarget 参数是否必选参数类型描述 name 是 String nas 配置名 type 是 String nas 配置协议类型 url 是 String nas 配置 ip 表7 ConfigObsTarget 参数是否必选参数类型描述 name 是 String obs 配置名 type 是 String obs 配置协议类型 url 是 String obs 桶 endpoint bucket 是 String obs 桶名

弹性文件服务 SFS 文件系统管理

弹性文件服务 SFS-获取文件系统异步任务详情:响应参数

响应参数状态码： 200 表3 响应Body参数参数参数类型描述 task_id String 任务ID status String 任务状态, SUC CES S表示成功，DOING表示正在执行，FAIL表示失败枚举值： SUCCESS DOING FAIL dir_usage FsDuInfo object 目录资源使用情况(包含子目录) begin_time String 任务开始时间，UTC时间，例如：2006-01-02 15:04:05' end_time String 任务结束时间，UTC时间，例如：2006-01-02 15:04:06' 表4 FsDuInfo 参数参数类型描述 path String 文件系统内合法的目录全路径最小长度：0 最大长度：4096 used_capacity Long 占用容量，单位：byte 最小值：0 file_count FsFileCount object 该目录下所有文件数目 message String 错误信息表5 FsFileCount 参数参数类型描述 dir Long 目录数目最小值：0 regular Long 普通文件数目最小值：0 pipe Long 管道文件数目最小值：0 char Long 字符设备数目最小值：0 block Long 块设备数目最小值：0 socket Long 套接字数目最小值：0 symlink Long 符号链接数目最小值：0 状态码： 400 表6 响应Body参数参数参数类型描述 errCode String 错误码最小长度：8 最大长度：36 errMsg String 错误描述最小长度：2 最大长度：512 状态码： 404 表7 响应Body参数参数参数类型描述 errCode String 错误码最小长度：8 最大长度：36 errMsg String 错误描述最小长度：2 最大长度：512 状态码： 500 表8 响应Body参数参数参数类型描述 errCode String 错误码最小长度：8 最大长度：36 errMsg String 错误描述最小长度：2 最大长度：512

弹性文件服务 SFS 文件系统管理

弹性文件服务 SFS-获取文件系统异步任务详情:请求示例

请求示例文件系统ID为"630509b1-ded4-476e-8d06-dbbc3dc23900",任务ID为"11abef677ac40f46644d1d5cfc2424a4"，获取DU任务详情 GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/630509b1-ded4-476e-8d06-dbbc3dc23900/fs/dir-usage/tasks/11abef677ac40f46644d1d5cfc2424a4

弹性文件服务 SFS 文件系统管理

弹性文件服务 SFS-获取文件系统异步任务详情:响应示例

响应示例状态码： 200 成功 { "task_id" : "2b31ed520xxxxxxebedb6e57xxxxxxxx", "status" : "SUCCESS", "dir_usage" : { "path" : "/path", "used_capacity" : 0, "file_count" : { "dir" : 0, "regular" : 0, "pipe" : 0, "char" : 0, "block" : 0, "socket" : 0, "symlink" : 0 }, "message" : "" }, "begin_time" : "2023-03-01 11:46:01", "end_time" : "2023-03-01 11:46:01" } 状态码： 400 错误响应 { "errCode" : "SFS.TURBO.0123", "errMsg" : "feature invalid" } 状态码： 404 错误响应 { "errCode" : "SFS.TURBO.0124", "errMsg" : "task_id not found" } 状态码： 500 错误响应 { "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }

弹性文件服务 SFS 文件系统管理

弹性文件服务 SFS-获取文件系统异步任务详情:URI

URI GET /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/{feature}/tasks/{task_id} 表1 路径参数参数是否必选参数类型描述 project_id 是 String 项目id share_id 是 String 文件系统id feature 是 String 任务类型。例，DU任务取值为dir-usage task_id 是 String 任务ID

弹性文件服务 SFS 文件系统管理

弹性文件服务 SFS-获取文件系统异步任务详情:接口约束

接口约束在2023年8月1号之后创建的文件系统支持该API操作。后端有5min的缓存时间，查询的数据可能有延迟。API请求路径的feature仅支持以下取值： dir-usage 该接口仅适用于以下类型： 20MB/s/TiB 40MB/s/TiB 125MB/s/TiB 250MB/s/TiB 500MB/s/TiB 1000MB/s/TiB HPC缓存型文件系统标准型、标准型-增强版、性能型、性能型-增强版类型的SFS Turbo文件系统，请使用“查询目录资源使用情况”接口。

弹性文件服务 SFS 文件系统管理

云服务器内容精选

文件系统管理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线