弹性文件服务 SFS-华为云

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

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 tasks Array of OneFsTaskResp objects 任务列表表5 OneFsTaskResp 参数参数类型描述 task_id String 任务ID status String 任务状态, SUC CES S表示成功，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' 表6 FsDuInfo 参数参数类型描述 path String 文件系统内合法的目录全路径 used_capacity Long 占用容量，单位：byte file_count FsFileCount object 该目录下所有文件数目 message String 错误信息表7 FsFileCount 参数参数类型描述 dir Long 目录数目 regular Long 普通文件数目 pipe Long 管道文件数目 char Long 字符设备数目 block Long 块设备数目 socket Long 套接字数目 symlink Long 符号链接数目状态码： 400 表8 响应Body参数参数参数类型描述 errCode String 错误码 errMsg String 错误描述状态码： 404 表9 响应Body参数参数参数类型描述 errCode String 错误码 errMsg String 错误描述状态码： 500 表10 响应Body参数参数参数类型描述 errCode String 错误码 errMsg String 错误描述

弹性文件服务 SFS

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

响应示例状态码： 200 成功 { "tasks" : [ { "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-获取文件系统异步任务列表:请求示例

请求示例 ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde的文件系统，获取DU任务列表,从任务ID为"11abef677ac40f46644d1d5cfc2424a4"起，获取50个任务 GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde/fs/dir-usage/tasks?marker=11abef677ac40f46644d1d5cfc2424a4&limit=50

弹性文件服务 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

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

URI GET /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/{feature}/tasks 表1 路径参数参数是否必选参数类型描述 project_id 是 String 项目id share_id 是 String 文件系统id feature 是 String 任务类型。例，DU任务取值为dir-usage 表2 Query参数参数是否必选参数类型描述 marker 否 String marker，取值为task_id limit 否 Integer limit, 取值为正整数. 默认为20，最大值为100

弹性文件服务 SFS

弹性文件服务 SFS-创建文件系统异步任务:响应示例

响应示例状态码： 202 Accepted { "task_id" : "d651ea2b-2b20-4c6d-8bbf-2adcec18dac9" } 状态码： 400 错误响应 { "errCode" : "SFS.TURBO.0123", "errMsg" : "feature invalid" } 状态码： 500 错误响应 { "errCode" : "SFS.TURBO.0005", "errMsg" : "internal server error" }

弹性文件服务 SFS

弹性文件服务 SFS-创建文件系统异步任务:接口约束

接口约束在2023年8月1号之后创建的文件系统支持该API操作。如果存在10个正在执行的任务，则不允许创建新任务。该接口并发请求数过大可能会影响文件系统性能，建议同时提交的查询请求不要超过4 个。查询超大目录耗时较久，请不要重复提交。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

弹性文件服务 SFS-取消/删除文件系统异步任务:URI

URI DELETE /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操作。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

弹性文件服务 SFS-取消/删除文件系统异步任务:响应参数

响应参数状态码： 400 表3 响应Body参数参数参数类型描述 errCode String 错误码 errMsg String 错误描述状态码： 404 表4 响应Body参数参数参数类型描述 errCode String 错误码 errMsg String 错误描述状态码： 500 表5 响应Body参数参数参数类型描述 errCode String 错误码 errMsg String 错误描述

弹性文件服务 SFS

弹性文件服务 SFS-取消/删除文件系统异步任务:响应示例

响应示例状态码： 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-取消/删除文件系统异步任务:请求示例

请求示例 ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"的文件系统，删除任务ID为"11abef677ac40f46644d1d5cfc2424a4"的DU任务 DELETE HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde/fs/dir-usage/tasks/11abef677ac40f46644d1d5cfc2424a4

弹性文件服务 SFS

弹性文件服务 SFS-查询文件系统详细信息:响应示例

响应示例状态码： 200 查询文件系统返回body { "id" : "8fba8253-c914-439d-ae8b-d5c89d0bf5e8", "name" : "sfs-turbo-8468", "status" : "200", "version" : "1.0.0", "region" : "example", "availability_zone" : "example", "az_name" : "example", "created_at" : "2018-11-19T04:02:03", "export_location" : "192.168.xx.xx:/", "action_progress" : { }, "share_type" : "STANDARD", "sub_status" : "221", "vpc_id" : "b24e39e1-bc0c-475b-ae0c-aef9cf240af3", "subnet_id" : "86fc01ea-8ec8-409d-ba7a-e0ea16d4fd97", "security_group_id" : "50586458-aec9-442c-bb13-e08ddc6f1b7a", "size" : "600.00", "avail_capacity" : "600.00", "pay_model" : "0", "share_proto" : "NFS" }

弹性文件服务 SFS

弹性文件服务 SFS-获取文件系统列表:响应示例

响应示例状态码： 200 查询列表成功，返回body { "shares" : [ { "id" : "8fba8253-c914-439d-ae8b-d5c89d0bf5e8", "name" : "sfs-turbo-8468", "status" : "100", "version" : "1.0.0", "region" : "example", "created_at" : "2018-11-19T04:02:03", "action_progress" : { "CREATING" : "22%" }, "share_type" : "STANDARD", "sub_status" : "", "availability_zone" : "az1.dc1", "az_name" : "az1", "vpc_id" : "b24e39e1-bc0c-475b-ae0c-aef9cf240af3", "subnet_id" : "86fc01ea-8ec8-409d-ba7a-e0ea16d4fd97", "security_group_id" : "50586458-aec9-442c-bb13-e08ddc6f1b7a", "size" : "500.00", "pay_model" : "0", "avail_capacity" : "500.00", "share_proto" : "NFS" }, { "id" : "65f2d30b-7b4e-4786-9608-4324faef6646", "name" : "sfs-turbo-df12", "status" : "200", "version" : "1.0.0", "region" : "example", "created_at" : "2018-11-15T02:32:10", "export_location" : "192.168.xx.xx:/", "optional_endpoint" : "192.168.xx.xx 192.168.xx.xx", "share_type" : "HPC_PERFORMANCE_250M", "expand_type" : "hpc", "sub_status" : "", "availability_zone" : "az1.dc1", "az_name" : "az1", "vpc_id" : "b24e39e1-bc0c-475b-ae0c-aef9cf240af3", "subnet_id" : "86fc01ea-8ec8-409d-ba7a-e0ea16d4fd97", "security_group_id" : "50586458-aec9-442c-bb13-e08ddc6f1b7a", "size" : "3686.00", "pay_model" : "0", "avail_capacity" : "3686.00", "share_proto" : "NFS" } ] }

弹性文件服务 SFS 生命周期管理

弹性文件服务 SFS-创建数据导入导出任务:请求示例

请求示例创建快速导入任务，任务类型是"import_metadata"，联动目录名称是"sfs-link-directory"，关联OBS桶内的源端路径前缀是"input/datasets/"。 POST HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/{share_id}/hpc-cache/task { "type" : "import_metadata", "src_target" : "sfs-link-directory", "src_prefix" : "input/datasets/", "dest_target" : "sfs-link-directory", "dest_prefix" : "input/datasets/" } 创建快速导入任务，任务类型是"import_metadata"，联动目录名称是"sfs-link-directory"，关联OBS桶内的源端路径前缀是"input/datasets/"；指定导入的文件在文件系统内的权限为755，目录权限为755。 POST HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/{share_id}/hpc-cache/task { "type" : "import_metadata", "src_target" : "sfs-link-directory", "src_prefix" : "input/datasets/", "dest_target" : "sfs-link-directory", "dest_prefix" : "input/datasets/", "attributes" : { "file_mode" : 755, "dir_mode" : 755 } } 创建数据预热任务，任务类型是"preload"，联动目录名称是"sfs-link-directory"，关联OBS桶内的源端路径前缀是"input/datasets/"；指定导入的文件在文件系统内的权限为755，目录权限为755，uid为0，gid为0。 POST HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/{share_id}/hpc-cache/task { "type" : "preload", "src_target" : "sfs-link-directory", "src_prefix" : "input/datasets/", "dest_target" : "sfs-link-directory", "dest_prefix" : "input/datasets/", "attributes" : { "file_mode" : 755, "dir_mode" : 755, "uid" : 0, "gid" : 0 } }

弹性文件服务 SFS 存储联动管理

云服务器内容精选

弹性文件服务 SFS

7*24

备案

专业服务

退订

建议反馈

售前咨询热线