华为云用户手册

文件系统性能数据 SFS Turbo文件系统的性能主要有IOPS和吞吐量等指标，具体各指标数据参见表1。 表1 性能数据表 参数 20MB/s/TiB 40MB/s/TiB 125MB/s/TiB 250MB/s/TiB 500MB/s/TiB 1000MB/s/TiB 最大容量 1PB 1PB 1PB 1PB 1PB 1PB 最大IOPS 25万 25万 100万 100万 400万 如需提高IOPS，请提交工单申请，最高可达3000万 400万 如需提高IOPS，请提交工单申请，最高可达3000万 最大吞吐量 8GB/s 如需提高吞吐能力，请提交工单申请，最高可达20 GBps 8GB/s 如需提高吞吐能力，请提交工单申请，最高可达20 GBps 20GB/s 如需提高吞吐能力，请提交工单申请，最高可达100 GBps 20GB/s 如需提高吞吐能力，请提交工单申请，最高可达100 GBps 80GB/s 如需提高吞吐能力，请提交工单申请，最高可达2TBps 80GB/s 如需提高吞吐能力，请提交工单申请，最高可达2TBps IOPS性能计算公式 IOPS=min(250000,600×容量) 其中，容量单位为TB IOPS=min(250000,1200×容量) 其中，容量单位为TB IOPS=min(1000000,6000×容量) 其中，容量单位为TB IOPS=min(1000000,12500×容量) 其中，容量单位为TB IOPS=min(4000000,25000×容量) 其中，容量单位为TB IOPS=min(4000000,50000×容量) 其中，容量单位为TB

通用测试配置样例 本文以SFS Turbo性能增强型，云服务器规格如下为例说明。 规格：通用计算增强型 | c6.4xlarge.4 | 16vCPUs | 64GB 镜像：EulerOS 2.5 单队列随机读 fio命令： fio -direct=1 -iodepth=1 -rw=randread -ioengine=libaio -bs=4k -size=10G -numjobs=1 -runtime=60 -group_reporting -filename=/mnt/sfsturbo/fio_test_01 -name=randread_test 其中，“/mnt/sfsturbo/fio_test_01 -name”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“fio_test_01 -name”文件，请根据实际填写。 fio结果： 单队列随机写 fio命令： fio -direct=1 -iodepth=1 -rw=randwrite -ioengine=libaio -bs=4k -size=10G -numjobs=1 -runtime=60 -group_reporting -filename=/mnt/sfsturbo/fio_test_02 -name=randwrite_test 其中，“/mnt/sfsturbo/fio_test_02 -name”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“fio_test_02 -name”文件，请根据实际填写。 fio结果： 单队列顺序读 fio命令： fio -direct=1 -iodepth=1 -rw=read -ioengine=libaio -bs=4k -size=10G -numjobs=1 -runtime=60 -group_reporting -filename=/mnt/sfsturbo/fio_test_03 -name=read_test 其中，“/mnt/sfsturbo/fio_test_03 -name”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo/”目录下的“fio_test_03 -name”文件，请根据实际填写。 fio结果： 单队列顺序写 fio命令： fio -direct=1 -iodepth=1 -rw=write -ioengine=libaio -bs=4k -size=10G -numjobs=1 -runtime=60 -group_reporting -filename=/mnt/sfsturbo/fio_test_04 -name=write_test 其中，“/mnt/sfsturbo/fio_test_04 -name”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“fio_test_04 -name”文件，请根据实际填写。 fio结果：

通用测试配置样例 以下提供的预估值为单台弹性 云服务器ECS 测试的结果。建议使用多台E CS 测试，以达到弹性文件服务的性能指标。 本文以SFS Turbo性能型，云服务器规格如下为例说明。 规格：通用计算增强型 | c3.xlarge.4 | 4vCPUs | 16GB 镜像：CentOS 7.564bit fio命令： fio --randrepeat=1 --ioengine=libaio --name=test -output=output.log --direct=1 --filename=/mnt/nfs/test_fio --bs=4k --iodepth=128 --size=10240M --readwrite=rw --rwmixwrite=30 --fallocate=none 其中，“/mnt/nfs/test_fio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/nfs”目录下的“test_fio”文件，请根据实际填写。 fio结果： fio命令： fio --randrepeat=1 --ioengine=libaio --name=test -output=output.log --direct=1 --filename=/mnt/nfs/test_fio --bs=4k --iodepth=128 --size=10240M --readwrite=rw --rwmixwrite=70 --fallocate=none 其中，“/mnt/nfs/test_fio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/nfs”目录下的“test_fio”文件，请根据实际填写。 fio结果： 顺序读IOPS fio命令： fio --ioengine=libaio --direct=1 --fallocate=none --time_based=1 --group_reporting=1 --name=iops_fio --directory=/mnt/sfs-turbo/ --rw=read --bs=4k --size=1G --iodepth=128 --runtime=120 --numjobs=10 其中，“/mnt/sfs-turbo/”为待测试的目标文件的挂载路径，需具体到文件名，请根据实际填写。 fio结果： 随机读IOPS fio命令： fio --ioengine=libaio --direct=1 --fallocate=none --time_based=1 --group_reporting=1 --name=iops_fio --directory=/mnt/sfs-turbo/ --rw=randread --bs=4k --size=1G --iodepth=128 --runtime=120 --numjobs=10 其中，“/mnt/sfs-turbo/”为待测试的目标文件的挂载路径，需具体到文件名，请根据实际填写。 fio结果： 顺序写IOPS fio命令： fio --ioengine=libaio --direct=1 --fallocate=none --time_based=1 --group_reporting=1 --name=iops_fio --directory=/mnt/sfs-turbo/ --rw=write --bs=4k --size=1G --iodepth=128 --runtime=120 --numjobs=10 其中，“/mnt/sfs-turbo/”为待测试的目标文件的挂载路径，需具体到文件名，请根据实际填写。 fio结果： 随机写IOPS fio命令： fio --ioengine=libaio --direct=1 --fallocate=none --time_based=1 --group_reporting=1 --name=iops_fio --directory=/mnt/sfs-turbo/ --rw=randwrite --bs=4k --size=1G --iodepth=128 --runtime=120 --numjobs=10 其中，“/mnt/sfs-turbo/”为待测试的目标文件的挂载路径，需具体到文件名，请根据实际填写。 fio结果： 顺序读带宽 fio命令： fio --randrepeat=1 --ioengine=libaio --name=test -output=output.log --direct=1 --filename=/mnt/sfs-turbo/test_fio --bs=1M --iodepth=128 --size=10240M --readwrite=read --fallocate=none 其中，“/mnt/sfs-turbo/test_fio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfs-turbo”目录下的“test_fio”文件，请根据实际填写。 fio结果： 随机读带宽 fio命令： fio --ioengine=libaio --direct=1 --fallocate=none --time_based=1 --group_reporting=1 --name=iops_fio --directory=/mnt/sfs-turbo/ --rw=randread --bs=1M --size=10G --iodepth=128 --runtime=120 --numjobs=1 其中，“/mnt/sfs-turbo/”为待测试的目标文件的挂载路径，需具体到文件名，请根据实际填写。 fio结果： 顺序写带宽 fio命令： fio --ioengine=libaio --direct=1 --fallocate=none --time_based=1 --group_reporting=1 --name=iops_fio --directory=/mnt/sfs-turbo/ --rw=write --bs=1M --size=10G --iodepth=128 --runtime=120 --numjobs=1 其中，“/mnt/sfs-turbo/”为待测试的目标文件的挂载路径，需具体到文件名，请根据实际填写。 fio结果： 随机写带宽 fio命令： fio --ioengine=libaio --direct=1 --fallocate=none --time_based=1 --group_reporting=1 --name=iops_fio --directory=/mnt/sfs-turbo/ --rw=randwrite --bs=1M --size=10G --iodepth=128 --runtime=120 --numjobs=1 其中，“/mnt/sfs-turbo/”为待测试的目标文件的挂载路径，需具体到文件名，请根据实际填写。 fio结果：

文件系统性能数据 SFS Turbo文件系统的性能主要有IOPS和吞吐量等指标，具体各指标数据参见表1。 表1 性能数据表 参数 HPC型 20MB/s/TiB 40MB/s/TiB 125MB/s/TiB 250MB/s/TiB 500MB/s/TiB 1000MB/s/TiB 最大容量 1PB 1PB 1PB 1PB 1PB 1PB 最大IOPS 25万 25万 100万 100万 400万 400万 最大吞吐量 8GB/s 8GB/s 20GB/s 20GB/s 80GB/s 80GB/s IOPS性能计算公式 IOPS=min(250000,600×容量) 其中，容量单位为TB IOPS=min(250000,1200×容量) 其中，容量单位为TB IOPS=min(1000000,6000×容量) 其中，容量单位为TB IOPS=min(1000000,12500×容量) 其中，容量单位为TB IOPS=min(4000000,25000×容量) 其中，容量单位为TB IOPS=min(4000000,50000×容量) 其中，容量单位为TB

响应示例 { "tags":[ { "key":"key1", "values":[ "value1", "value2" ] }, { "key":"key2", "values":[ "value1", "value2" ] } ] }

请求示例 projectId为“c80a2157ba1d46c0825265947342077c”，查询资源实例数量示例： POST https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/resource-instances/count 请求体示例： { "tags":[ { "key":"key1", "values":[ "value1", "value2" ] }, { "key":"key2", "values":[ "value1", "value2" ] } ], "matches":[ { "key":"resource_name", "value":"resource1" } ], "without_any_tag":"true" }

响应示例 { "resources":[ { "resource_detail":"", "resource_id":"resouece1", "resource_name":"resouece1", "tags":[ { "key":"key1", "value":"value1" } ], "sys_tags":[] } ], "total_count":1 }

请求示例 projectId为“c80a2157ba1d46c0825265947342077c”，offset为0，limit为10，查询资源实例示例： POST https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/resource-instances/filter?limit=10&offset=0 请求体示例： { "tags":[ { "key":"key1", "values":[ "value1", "value2" ] }, { "key":"key2", "values":[ "value1", "value2" ] } ], "matches":[ { "key":"resource_name", "value":"resource1" } ], "without_any_tag":"false" }

URI POST /v3/sfs/tms/{project_id}/file-systems/resource-instances/filter 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 操作用户的项目ID，获取方法请参见获取项目ID。 limit 否 Int 查询记录数。默认为1000，limit最大为1000，最小值为1，不能为负数。 offset 否 Int 索引位置。 从第一条数据偏移offset条数据后开始查询。默认为0（偏移0条数据，表示从第一条数据开始查询）,必须为数字，不能为负数。

请求示例 projectId为“c80a2157ba1d46c0825265947342077c”，通用文件系统名为“bucketName”，批量添加资源标签示例： POST https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/bucketName/tags/create 请求体示例： { "tags":[ { "key":"key1", "value":"value1" }, { "key":"key2", "value":"value2" } ] }

配额管理 表3 配额管理权限项列表 权限 对应API接口 授权项 IAM 项目 (Project) 企业项目 (Enterprise Project) 获取文件系统配额 GET /{file-system-name}?quota sfs3:fileSystem:getQuota × √ 设置文件系统配额 PUT /{file-system-name}?quota sfs3:fileSystem:putQuota × √

生命周期管理 表5 生命周期管理权限项列表 权限 对应API接口 授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 设置文件系统生命周期配置 PUT /{file-system-name}?lifecycle sfs3:fileSystem:putLifecycleConfiguration × √ 获取文件系统生命周期配置 GET /{file-system-name}?lifecycle sfs3:fileSystem:getLifecycleConfiguration × √ 删除文件系统生命周期配置 DELETE /{file-system-name}?lifecycle sfs3:fileSystem:putLifecycleConfiguration × √

标签管理 表6 标签管理权限项列表 权限 对应API接口 授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 批量添加资源标签 POST /v3/sfs/tms/{project_id}/file-systems/{resource_id}/tags/create sfs3:tags:tagResource × √ 批量删除资源标签 POST /v3/sfs/tms/{project_id}/file-systems/{resource_id}/tags/delete sfs3:tags:unTagResource × √ 查询资源标签 GET /v3/sfs/tms/{project_id}/file-systems/{resource_id}/tags sfs3:tags:listTagsForResource × √ 查询资源实例列表 POST /v3/sfs/tms/{project_id}/file-systems/resource-instances/filter sfs3:tags:listResourcesByTag × √ 查询资源实例数量 POST /v3/sfs/tms/{project_id}/file-systems/resource-instances/count sfs3:tags:listResourcesByTag × √ 查询项目标签 GET /v3/sfs/tms/{project_id}/file-systems/tags sfs3:tags:listTags × √

文件共享 表1 文件共享权限项列表 权限 对应API接口 授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 创建文件系统 PUT /{file-system-name} sfs3:fileSystem:createFileSystem × √ 查询文件系统信息 HEAD /{file-system-name} sfs3:fileSystem:getFileSystem × √ 获取文件系统列表 GET / sfs3:fileSystem:listFileSystems × √ 删除文件系统 DELETE /{file-system-name} sfs3:fileSystem:deleteFileSystem × √

共享访问规则 表2 共享访问规则权限项列表 权限 对应API接口 授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 设置文件系统acl PUT /{file-system-name}?sfsacl sfs3:fileSystem:putACL × √ 获取文件系统acl GET /{file_system_name}/?sfsacl sfs3:fileSystem:getACL × √ 删除文件系统acl DELETE /{file_system_name}/?sfsacl sfs3:fileSystem:deleteACL × √

获取访问密钥（AK/SK） IAM用户若希望使用AK/SK访问SFS，必须要账号为其开启“编程访问”。开启方法请参见查看或修改IAM用户信息。 在调用接口的时候，需要使用AK/SK进行签名验证。AK/SK获取步骤如下： 登录控制台。 鼠标指向界面右上角的登录用户名，在下拉列表中单击“我的凭证”。 单击“管理访问密钥”。 在左侧导航栏单击“访问密钥”。 单击“新增访问密钥”，进入“新增访问密钥”页面。 输入当前用户的登录密码。 通过邮箱或者手机进行验证，输入对应的验证码。 在 统一身份认证 服务IAM中创建的用户，如果创建时未填写邮箱或者手机号，则只需校验登录密码。 单击“确定”，浏览器自动下载访问密钥。 为防止访问密钥泄露，建议您将其保存到安全的位置。 父主题： 附录

响应示例 HTTP/1.1 204 No Content Server: OBS X-Obs-Id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAA BCS j4dxiqb1Lw50CTjVQeV3ebh3QQ6PAj X-Obs-Request-Id: 0000018893B807D5C0472A6161D87032 Date: WED, 01 Jul 2015 02:36:06 GMT

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 Statement Array of Statement objects Unique identification 表4 Statement 参数 参数类型 描述 Sid String statement Id，描述statement的字符串 Action String 本条statement作用的操作，取值范围：FullControl（读写）、Read（只读）。 枚举值： FullControl Read Effect String 效果，指定本条statement的权限是允许，必须为Allow。 枚举值： Allow Condition Condition object 本条statement生效的条件。 表5 Condition 参数 参数类型 描述 SourceVpc String 指定VPC的VPCid。 VpcSourceIp Array of strings 指定的IP或IP范围（暂不支持该参数）。

响应示例 HTTP/1.1 200 OK Server: OBS Content-Type: application/json Content-Length: 131 Date: Wed, 07 Jun 2023 03:31:59 GMT X-Obs-Request-Id: 0000018893E94B65C046B527778F8F14 X-Obs-Id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSc2lEdSHcA04319WknB1DD5BdBKuGr1 { "Statement": [ { "Condition": { "SourceVpc": "f85adabc-a387-4d1d-94cf-65ef9034f752" }, "Action": "FullControl", "Effect": "Allow", "Sid": "" } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Date 是 String 请求消息时间 Authorization 是 String 请求签名信息 Host 是 String 表明主机地址。如filesystem.sfs3.cn-north-4.myhuaweicloud.com。 表3 请求Body参数 参数 是否必选 参数类型 描述 Statement 否 Array of Statement objects Unique identification 表4 Statement 参数 是否必选 参数类型 描述 Sid 否 String statement Id，描述statement的字符串 Action 是 String 本条statement作用的操作，取值范围：FullControl（读写）、Read（只读）。 枚举值： FullControl Read Effect 是 String 效果，指定本条statement的权限是允许，必须为Allow。 枚举值： Allow Condition 是 Condition object 本条statement生效的条件。 表5 Condition 参数 是否必选 参数类型 描述 SourceVpc 是 String 指定VPC的VPCid。 VpcSourceIp 否 Array of strings 指定的IP或IP范围（暂不支持该参数）。

请求示例 设置文件系统ACL，授予读写权限，VPC ID为“241dbf6b-dc5d-41b2-9108-ca5e56b48386”，IP范围为["127.0.0.1/24", "192.168.1.85/24"]。 PUT /?sfsacl HTTP/1.1 Host: examplefilesystem.sfs3.cn-north-4.myhuaweicloud.com Date: WED, 01 Jul 2015 02:32:25 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:jZiAT8Vx4azWEvPRMWi0X5BpJMA= { "Statement": [{ "Sid": "Stmt1375240018061", "Action": "FullControl", "Effect": "Allow", "Condition": { "SourceVpc": "241dbf6b-dc5d-41b2-9108-ca5e56b48386", "VpcSourceIp": ["127.0.0.1/24", "192.168.1.85/24"] } }] }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 Owner Owner object 文件系统拥有者信息，包含租户ID Buckets Buckets object 用户所拥有的文件系统列表 表3 Owner 参数 参数类型 描述 ID String 用户的DomainID（账号ID） 表4 Buckets 参数 参数类型 描述 Bucket Bucket object 具体的文件系统信息 表5 Bucket 参数 参数类型 描述 Name String 文件系统名称 CreationDate String 文件系统的创建时间 Location String 文件系统的位置信息

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 x-obs-bucket-type 是 String 通过此消息头明确获取的列表内容。 取值： SFS：获取所有文件系统列表。 枚举值： SFS Authorization 是 String 签名信息 Date 是 String 请求时间 Host 是 String 表明主机地址。如sfs3.cn-north-4.myhuaweicloud.com。

请求示例 DELETE / HTTP/1.1 User-Agent: curl/7.29.0 Host: examplefilesystem.sfs3.cn-north-4.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 02:31:25 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:jZiAT8Vx4azWEvPRMWi0X5BpJMA=

响应示例 HTTP/1.1 204 No Content Server: OBS X-Obs-Request-Id: 0000018893B8081DC047305E783867DD X-Obs-Id-2: 32AAAQAAEAABSkAgAAEAABAAAQAAEAABCT5UWgsaro3EEnOsNEzf8w8dnydR+Eak Date: WED, 01 Jul 2015 02:31:25 GMT

响应示例 HTTP/1.1 200 OK Server: OBS X-Obs-Request-Id: 0000018893B8058EC0470388BE6EDE88 Location: /example-sfs-01 X-Obs-Id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCTRa4voOUvr50ncznQT/hligMxL4so2z Date: Wed, 07 Jun 2023 02:38:11 GMT Content-Length: 0

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 签名信息 Date 是 String 请求时间 x-obs-bucket-type 是 String 通过此消息头明确创建文件系统。 取值： SFS：创建文件系统。 枚举值： SFS Host 是 String 表明主机地址。如filesystem.sfs3.cn-north-4.myhuaweicloud.com。 x-obs-epid 否 String 企业项目ID 表2 请求Body参数 参数 是否必选 参数类型 描述 Location 否 String 区域

响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 详细的公共响应消息头字段请参见表1。 表1 公共响应消息头 消息头名称 描述 Content-Length 响应消息体的字节长度。 类型：字符串。 默认值：无。 Connection 指明与服务器的连接是长连接还是短连接。 类型：字符串。 有效值：keep-alive | close。 默认值：无。 Date 系统响应的时间。 类型：字符串。 默认值：无。 x-obs-id-2 帮助定位问题的特殊符号。 类型：字符串。 默认值：无。 x-obs-request-id 由SFS创建来唯一确定本次请求的值，可以通过该值来定位问题。 类型：字符串。 默认值：无。

签名计算工具 SFS提供可视化签名计算工具，帮助您轻松完成签名计算。 表1 签名计算工具 签名计算方式 签名计算工具获取地址 Header中携带签名 可视化签名计算工具 若调用SFS API报如下错误： 状态码：403 Forbidden 错误码：SignatureDoesNotMatch 错误信息：The request signature we calculated does not match the signature you provided. Check your key and signing method. 请联系技术支持。 父主题： 认证鉴权

Java中Content-MD5的计算方法示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 import java.security.MessageDigest; import sun.misc.BASE64Encoder; import java.io.UnsupportedEncodingException; import java.security.NoSuchAlgorithmException; public class Md5{ public static void main(String[] args) { try { String exampleString = "blog"; MessageDigest messageDigest = MessageDigest.getInstance("MD5"); BASE64Encoder encoder = new BASE64Encoder(); String contentMd5 = encoder.encode(messageDigest.digest(exampleString.getBytes("utf-8"))); System.out.println("Content-MD5：" + contentMd5); } catch (NoSuchAlgorithmException | UnsupportedEncodingException e) { e.printStackTrace(); } } }