- 最新动态
- 功能总览
- 服务公告
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
- 场景代码示例
-
常见问题
- 概念类
- 规格类
- 限制类
- 网络类
- 计费类
-
其他类
- 如何从云服务器访问文件系统?
- 如何确认Linux云服务器上的文件系统处于可用状态?
- 弹性文件服务会占用用户的哪些资源?
- SFS容量型文件系统挂载后为什么容量显示为10P?
- 通用文件系统挂载后为什么会显示250TB?
- 如何在弹性文件服务SFS和对象存储服务OBS之间进行数据迁移?
- 弹性文件服务支持多可用区吗?
- 可以将SFS容量型文件系统升级为SFS Turbo文件系统吗?
- 可以将SFS Turbo标准型升级为SFS Turbo标准型-增强版吗?
- 如何在弹性文件服务SFS和云硬盘EVS之间进行数据迁移?
- 可以直接从云下访问弹性文件服务吗?
- 如何删除.nfs类型的文件?
- 将数据从SFS容量型迁移至SFS Turbo后,容量为什么变大了?
- 如何提高SFS Turbo文件系统拷贝和删除操作的效率?
- SFS Turbo二级及三级目录权限如何继承?
- 如何将SFS Turbo部署至CCE?
- 如何发挥SFS Turbo文件系统的最大性能?
- Linux内核5.4版本之后客户端的NFSv3文件系统顺序读业务场景性能不符合预期,如何处理?
- 故障排除
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
构造请求
本节介绍REST API请求的组成。
请求URI
SFS根据文件系统及带的资源参数来确定具体的URI,当需要进行资源操作时,可以使用这个URI地址。
URI的一般格式为(方括号内为可选项):
protocol://[filesystem.]domain[:port]/[?param]
参数 |
描述 |
是否必选 |
---|---|---|
protocol |
请求使用的协议类型,如HTTP、HTTPs。HTTPs表示通过安全的HTTPs访问该资源,SFS服务支持HTTP,HTTPs两种传输协议。 |
必选 |
filesystem |
请求使用的文件系统资源路径,在整个系统中唯一标识一个文件系统。 |
可选 |
domain |
存放资源的服务器的域名或IP地址。 |
必选 |
port |
请求使用的端口号。根据软件服务器的部署不同而不同。缺省时使用默认端口,各种传输协议都有默认的端口号,如HTTP的默认端口为80,HTTPs的默认端口为443。 SFS服务的http方式访问端口为80,HTTPs方式访问端口为443。 |
可选 |
param |
请求使用的文件系统的具体资源,缺省默认为请求文件系统自身资源。 |
可选 |
除获取文件系统列表之外的所有接口,都应当包含文件系统名。SFS基于DNS解析性能和可靠性的考虑,要求凡是携带文件系统名的请求,在构造URL的时候都必须将文件系统名放在domain前面,形成三级域名形式,又称为虚拟主机访问域名。
例如,如果您有一个位于cn-north-4区域的名为test-filesystem的文件系统,期望访问文件系统的acl,正确的访问URL为https://test-filesystem.sfs3.cn-north-4.myhuaweicloud.com/?sfsacl
请求方法
HTTP方法(也称为操作或动词),它告诉服务你正在请求什么类型的操作。
方法 |
说明 |
---|---|
GET |
请求服务器返回指定资源,如获取文件系统列表等。 |
PUT |
请求服务器更新指定资源,如创建文件系统等。 |
POST |
请求服务器新增资源或执行特殊操作。 |
DELETE |
请求服务器删除指定资源,如删除文件系统等。 |
HEAD |
请求服务器返回指定资源的概要。 |
OPTIONS |
请求服务器检查是否具有某个资源的操作权限。 |
请求消息头
可选的附加请求头字段,如指定的URI和HTTP方法所要求的字段。详细的公共请求消息头字段请参见表3。
消息头名称 |
描述 |
是否必选 |
---|---|---|
Authorization |
请求消息中可带的签名信息。 类型:字符串。 默认值:无。 条件:匿名请求不需要带,其他请求必选。 |
有条件必选 |
Content-Length |
RFC 2616中定义的消息(不包含消息头)长度。 类型:字符串。 默认值:无。 条件:PUT操作和加载XML的操作必须带。 |
有条件必选 |
Content-Type |
资源内容的类型,例如: text/plain。 类型:字符串。 默认值:无。 |
否 |
Date |
请求发起端的日期和时间,例如:Wed, 27 Jun 2018 13:39:15 +0000。 类型:字符串。 默认值:无。 条件:如果是匿名请求或者消息头中带了x-obs-date字段,则可以不带该字段,其他情况下必选。 |
有条件必选 |
Host |
表明主机地址。如filesystem.sfs3.cn-north-4.myhuaweicloud.com。 类型:字符串。 默认值:无。 |
是 |
请求消息体(可选)
请求消息体通常以结构化格式(如JSON或XML)发出,与请求消息头中Content-type对应,传递除请求消息头之外的内容。若请求消息体中参数支持中文,则中文字符必须为UTF-8编码。
每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。
发起请求
共有两种方式可以基于已构建好的请求消息发起请求,分别为:
- cURL
cURL是一个命令行工具,用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端,可以发送HTTP请求给服务端,并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl.haxx.se/。由于cURL无法计算签名,使用cURL时仅支持访问匿名的公共SFS资源。
- 编码