华为云用户手册

请求示例 文件系统ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"， 任务ID为"11abef677ac40f46644d1d5cfc2424a4"，删除该任务 "DELETE HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/77ba6f4b-6365-4895-8dda-bc7142af4dde/hpc-cache/task/11abef677ac40f46644d1d5cfc2424a4"

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 账号的token Content-Type 是 String MIME类型 表3 请求Body参数 参数 是否必选 参数类型 描述 path 是 String 合法的的目录全路径 mode 否 Long 目录权限，默认值是755，取值范围是0到777。第一位表示目录所有者的权限，取值范围是0到7；第二位表示目录所属用户组的权限，取值范围是0到7；第三位表示其他用户的权限，取值范围是0到7。目录所有者由uid指定，目录所属用户组由gid指定，不是目录所有者且不在目录所属用户组的用户为其他用户。例如：755中第一位7代表该目录所有者对该目录具有读、写、执行权限；第二位5代表该目录所属用户组对该目录具有读、执行权限；第三位5代表其他用户对该目录具有读、执行权限。 uid 否 Long 目录所有者的用户id，默认值是0，取值范围是0到4,294,967,294（即2^32-2）。 gid 否 Long 目录所属用户组id，默认值是0，取值范围是0到4,294,967,294（即2^32-2）。

响应示例 状态码：400 错误响应 { "errCode" : "SFS.TURBO.0122", "errMsg" : "invalid mode" } 状态码：409 错误响应，目录冲突 { "errCode" : "SFS.TURBO.0114", "errMsg" : "path already exist" } 状态码：500 错误响应 { "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }

响应参数 状态码：204 创建目录成功 状态码：400 表4 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述 状态码：409 表5 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述 状态码：500 表6 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述

请求示例 加入AD域 POST HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/{share_id}/fs/active-directory-domain { "service_account" : "administrator", "password" : "pwdxxxxx", "domain_name" : "SFSTURBO.COM", "system_name" : "sfs", "dns_server" : "100.xxx:xxx" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 账号的token Content-Type 是 String MIME类型 表3 请求Body参数 参数 是否必选 参数类型 描述 service_account 是 String 服务账号，在创建域服务器时指定，一般默认为administrator password 是 String 账号对应密码 domain_name 是 String 域控服务器的 域名 ，在创建域服务器时指定 system_name 是 String 存储系统在AD域中的名称 overwrite_same_account 否 Boolean 如果域控制器中已存在同系统名称的存储系统，开启该选项后，将覆盖原有的存储系统信息。 dns_server 是 Array of strings DNS服务器IP地址，用于解析AD域的域名 organization_unit 否 String 域中包含的一类目录对象如用户、计算机、打印机等资源的总称，加入后将作为其中的一员。若不填，则默认加入到computers组织单元。 vpc_id 否 String vpc的id

响应示例 状态码：400 错误响应 { "errCode" : "SFS.TURBO.0001", "errMsg" : "parameter domain_name is required and cannot be empty" } 状态码：500 错误响应 { "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }

响应参数 状态码：202 表4 响应Body参数 参数 参数类型 描述 job_id String 加入AD域异步任务的id 状态码：400 表5 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表6 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述 状态码：500 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表8 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述

响应示例 状态码：200 成功 { "sub_shares" : [ { "sub_share_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "path" : "/a", "uid" : 99, "gid" : 100, "mod" : 755 }, { "sub_share_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "path" : "/b", "uid" : 99, "gid" : 100, "mod" : 755 } ], "page_info" : { "total_count" : 1000, "current_count" : 2, "next_marker" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } } 状态码：400 错误提示 { "errCode" : "SFS.TURBO.0001", "errMsg" : "invalid marker" } 状态码：500 错误提示 { "errCode" : "SFS.TURBO.0005", "errMsg" : "internal server error" }

响应参数 状态码：200 表4 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表5 响应Body参数 参数 参数类型 描述 sub_shares Array of OneSubShareResp objects 接入点列表 page_info PageQueryForList object 分页查询相关信息 表6 OneSubShareResp 参数 参数类型 描述 sub_share_id String 接入点ID path String 接入点根目录的全路径 uid Long 接入点根目录的属主用户ID gid Long 接入点根目录的属主用户组ID mode Long 接入点根目录的权限 表7 PageQueryForList 参数 参数类型 描述 total_count Integer 总个数 current_count Integer 本次分页查询返回的个数 next_marker String 本次分页查询返回的最后一条记录的marker值，用户可用于下次分页查询 状态码：400 表8 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表9 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述 状态码：500 表10 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表11 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述

URI GET /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/sub-shares 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID share_id 是 String 文件系统ID 表2 Query参数 参数 是否必选 参数类型 描述 marker 否 String 分页查询起始值，取值为sub_share_id limit 否 Long 分页查询数量

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 账号的token Content-Type 是 String MIME类型 表3 请求Body参数 参数 是否必选 参数类型 描述 service_account 是 String 服务账号，在创建域服务器时指定，一般默认为administrator password 是 String 账号对应密码 domain_name 是 String 域控服务器的域名，在创建域服务器时指定 system_name 是 String 存储系统在AD域中的名称 overwrite_same_account 否 Boolean 如果域控制器中已存在同系统名称的存储系统，开启该选项后，将覆盖原有的存储系统信息。 dns_server 是 Array of strings DNS服务器IP地址，用于解析AD域的域名 organization_unit 否 String 域中包含的一类目录对象如用户、计算机、打印机等资源的总称，加入后将作为其中的一员。若不填，则默认加入到computers组织单元。 vpc_id 否 String vpc的id

请求示例 PUT HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/{share_id}/fs/active-directory-domain { "service_account" : "administrator", "password" : "pwdxxxxx", "domain_name" : "SFSTURBO.COM", "system_name" : "sfs", "dns_server" : "100.xxx:xxx" }

响应参数 状态码：202 表4 响应Body参数 参数 参数类型 描述 job_id String 修改AD域异步任务的id 状态码：400 表5 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表6 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述 状态码：500 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表8 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 domain_name String 域控服务器的域名，在创建域服务器时指定 system_name String 存储系统在AD域中的名称 dns_server Array of strings DNS服务器IP地址，用于解析AD域的域名 organization_unit String 域中包含的一类目录对象如用户、计算机、打印机等资源的总称，加入后将作为其中的一员。若不填，则默认加入到computers组织单元。 vpc_id String vpc的id status String AD域当前状态信息 枚举值： JOINING AVAILABLE EXITING FAILED 状态码：500 表4 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表5 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 账号的token Content-Type 是 String MIME类型 表3 请求Body参数 参数 是否必选 参数类型 描述 path 是 String 指定接入点在文件系统中的根目录，可以指定一个SFS Turbo内的一个子目录作为接入点根目录。通过接入点访问的用户，访问范围将被限制在此子目录内。必须以正斜线（/）开头。 uid 否 Integer 接入点根目录的属主用户ID。默认值是0，取值范围是0到4,294,967,294（即2^32-2）。如果接入点路径已存在，该配置会被忽略。 gid 否 Integer 接入点根目录的属主用户组ID。默认值是0，取值范围是0到4,294,967,294（即2^32-2）。 mode 否 Integer 接入点根目录的权限。默认值是755，取值范围是0到777。第一位表示接入点根目录的属主用户的权限，取值范围是0到7；第二位表示接入点根目录的属主用户组的权限，取值范围是0到7；第三位表示其他用户的权限，取值范围是0到7。接入点根目录的属主用户由uid指定，接入点根目录的属主用户组由gid指定，不是属主用户且不在属主用户组的用户为其他用户。例如：755中第一位7代表属主用户对该目录具有读、写、执行权限；第二位5代表属主用户组对该目录具有读、执行权限；第三位5代表其他用户对该目录具有读、执行权限。

响应参数 状态码：202 表4 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表5 响应Body参数 参数 参数类型 描述 job_id String 创建接入点的异步任务ID sub_share_id String 接入点ID 状态码：400 表6 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表7 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述 状态码：500 表8 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表9 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述

响应示例 状态码：202 任务下发成功 { "job_id" : "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "sub_share_id" : "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } 状态码：400 错误提示 { "errCode" : "SFS.TURBO.0100", "errMsg" : "root path is invalid" } 状态码：500 错误提示 { "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }

请求示例 文件系统ID为“xxxxxxxx-xxxx-xxxx-8d06-xxx3dc2xxxx”，接入点ID为“11111111-xxxx-xxxx-8d06-xxx3dc2xxxx”，删除接入点 DELETE HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/xxxxxxxx-xxxx-xxxx-8d06-xxx3dc2xxxx/fs/sub-shares/11111111-xxxx-xxxx-8d06-xxx3dc2xxxx

响应示例 状态码：202 任务下发成功 { "job_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } 状态码：400 错误提示 { "errCode" : "SFS.TURBO.0001", "errMsg" : "invalid sub_share_id" } 状态码：500 错误提示 { "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }

响应参数 状态码：202 表3 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表4 响应Body参数 参数 参数类型 描述 job_id String 删除接入点的异步任务ID 状态码：400 表5 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表6 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述 状态码：500 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表8 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述

响应示例 状态码：200 成功 查询当前所支持的文件系统类型和配额。 { "share_types" : [ { "share_type" : "standard", "scenario" : "Standard", "attribution" : { "capacity" : { "max" : 1048576, "min" : 100, "step" : 100 }, "bandwidth" : { "max" : 300, "min" : 150, "step" : -1, "density" : 40.96, "base" : 150 }, "iops" : { "max" : 20000, "min" : 1000 }, "single_channel_4k_latency" : { "max" : 20000, "min" : 1000 } }, "spec_code" : "sfs.turbo.standard", "storage_media" : "SATA", "support_period" : true, "available_zones" : [ { "available_zone" : "az1", "status" : "normal" } ], "features" : [ "periodic" ] }, { "share_type" : "hpc.125M", "scenario" : "Standard", "attribution" : { "capacity" : { "max" : 1048576, "min" : 512, "step" : 1228.8 }, "bandwidth" : { "max" : 20480, "min" : 150, "step" : -1, "density" : 125, "base" : 0 }, "iops" : { "max" : 1000000, "min" : 0 }, "single_channel_4k_latency" : { "max" : 3, "min" : 1 } }, "spec_code" : "sfs.turbo.standard", "storage_media" : "SATA", "support_period" : true, "available_zones" : [ { "available_zone" : "az1", "status" : "normal" } ], "features" : [ "periodic" ] } ] } 状态码：400 错误响应 { "errCode" : "SFS.TURBO.0001", "errMsg" : "parameter error" }

响应参数 状态码：200 表4 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表5 响应Body参数 参数 参数类型 描述 share_types Array of ShareTypeResponseBody objects 文件系统类型和配额列表 表6 ShareTypeResponseBody 参数 参数类型 描述 share_type String 文件系统类型 scenario String 文件系统场景 attribution ShareTypesAttribution object 文件系统属性 support_period Boolean 是否支持包周期 available_zones Array of ShareTypeAvailableZone objects 可用区 spec_code String 文件系统规格编码 storage_media String 存储类型 枚举值： HDD SSD ESSD features Array of strings 实例支持的特性列表 表7 ShareTypesAttribution 参数 参数类型 描述 capacity ShareTypesAttributionCapacity object 容量属性 bandwidth ShareTypesAttributionBandwidth object 带宽属性 iops ShareTypesAttributionIops object iops属性 single_channel_4k_latency ShareTypesAttributionSingleChannel4KLatency object 平均单路4K延迟属性 表8 ShareTypesAttributionCapacity 参数 参数类型 描述 max Integer 最大容量 min Integer 最小容量 step Number 容量梯度 表9 ShareTypesAttributionBandwidth 参数 参数类型 描述 max Integer 最大带宽 min Integer 最小带宽 step Integer 带宽梯度 density Number 带宽密度 base Integer 基础带宽 表10 ShareTypesAttributionIops 参数 参数类型 描述 max Integer 最大iops min Integer 最小iops 表11 ShareTypesAttributionSingleChannel4KLatency 参数 参数类型 描述 max Integer 最大值 min Integer 最小值 表12 ShareTypeUsage 参数 参数类型 描述 capacity ShareTypeUsageCapacity object 文件系统容量 bandwidth ShareTypeUsageBandwidth object 文件系统带宽 quantity ShareTypeUsageQuantity object 文件系统数目 表13 ShareTypeUsageCapacity 参数 参数类型 描述 total Integer 总容量 usage Integer 已用容量 表14 ShareTypeUsageBandwidth 参数 参数类型 描述 total Integer 总带宽 usage Integer 已用带宽 表15 ShareTypeUsageQuantity 参数 参数类型 描述 total Integer 总文件系统数量 usage Integer 文件系统已用数量 表16 ShareTypeAvailableZone 参数 参数类型 描述 available_zone String 可用区 status String 在可用区的状态 枚举值： normal sellout 状态码：400 表17 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表18 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述

响应示例 状态码：200 批量删除目录quota的多状态结果 { "resources": [ { "path": "/a", "ret_status": "successful", "capacity": 1024, "inode": 1000, "used_capacity": 0, "used_inode": 0 }, { "path": "/b", "ret_status": "error", "err_code": "SFS.TURBO.xxxx", "err_message": "xxxxx", } ] } 状态码：400 错误响应 { "errCode" : "SFS.TURBO.0102", "errMsg" : "Path is not directory" } 状态码：500 错误响应 { "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 resources Array of BatchQuotaPartiallySuccessUnit objects 目录列表 表5 BatchQuotaPartiallySuccessUnit 参数 参数类型 描述 path String 目录全路径 ret_status String 目录quota操作结果 枚举值： successful error capacity Integer 目录的容量大小限制，单位：MB inode Integer 目录的inode数量限制 used_capacity Integer 目录的已用容量 used_inode Integer 目录的已用inode数量 err_code String 错误码 err_message String 错误信息 状态码：400 表6 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表7 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述 状态码：500 表8 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表9 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 账号的token Content-Type 是 String MIME类型 表3 请求Body参数 参数 是否必选 参数类型 描述 service_account 是 String 服务账号，在创建域服务器时指定，一般默认为administrator password 是 String 账号对应密码

响应参数 状态码：202 表4 响应Body参数 参数 参数类型 描述 job_id String 退出AD域异步任务的id 状态码：400 表5 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表6 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述 状态码：500 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表8 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述

响应参数 状态码：200 表3 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表4 响应Body参数 参数 参数类型 描述 sub_share_id String 接入点ID path String 接入点根目录的全路径 uid Long 接入点根目录的属主用户ID gid Long 接入点根目录的属主用户组ID mode Long 接入点根目录的权限 状态码：400 表5 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表6 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述 状态码：500 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID 表8 响应Body参数 参数 参数类型 描述 errCode String 错误码 errMsg String 错误描述

请求示例 文件系统ID为“xxxxxxxx-xxxx-xxxx-8d06-xxx3dc2xxxx”，接入点ID为“11111111-xxxx-xxxx-8d06-xxx3dc2xxxx”查询接入点列表 GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/xxxxxxxx-xxxx-xxxx-8d06-xxx3dc2xxxx/fs/sub-shares/11111111-xxxx-xxxx-8d06-xxx3dc2xxxx

响应示例 状态码：200 成功 { "sub_share_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "path" : "/test", "uid" : 99, "gid" : 100, "mod" : 755 } 状态码：400 错误提示 { "errCode" : "SFS.TURBO.0001", "errMsg" : "invalid sub_share_id" } 状态码：500 错误提示 { "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }