TFS图片服务器 相关文档 TFS RESTful API

最新推荐文章于 2021-05-10 16:31:24 发布
最新推荐文章于 2021-05-10 16:31:24 发布
阅读量1.4k 收藏 1
点赞数

TFS RESTful API

注：API语法描述中的粗体为API语法规定的保留关键字部分，斜体为用户输入部分

原生TFS

写文件

描述

此API用于将数据保存成一个TFS文件并以JSON格式返回TFS的文件名

语法

POST /v1/appkey HTTP/1.1

Host: 10.0.0.1:7500

Content-Length: length

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符，若无使用RcServer，使用tfs即可

请求参数
参数名描述
suffix文件后缀
simple_name是否要求必须带正确后缀才可访问存入的TFS文件
1：要求必须带正确后缀才可访问
0：不带后缀也可访问
large_file是否存成大文件（文件名以L开头）
1：存成大文件
0：不存成大文件
应答
名称描述
TFS_FILE_NAME返回的TFS文件名
返回的状态码
HTTP状态码描述
200 OK操作成功
400 Bad Request错误的请求
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey写一个不带后缀的TFS文件：

POST /v1/tfs HTTP/1.1
Host: 10.0.0.1:7500
Content-Length: 22
Date: Fri, 30 Nov 2012 03:05:00 GMT

[data]

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Fri, 30 Nov 2012 03:05:00 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive

{
    "TFS_FILE_NAME": "T1FOZHB4ET1RCvBVdK"
}

下面这个请求，将会使用tfs这个appkey写一个带“.jpg”后缀的TFS文件，并且要求必须带该后缀才能访问该文件：

POST /v1/tfs?suffix=.jpg&simple_name=1 HTTP/1.1
Host: 10.0.0.1:7500
Content-Length: 22
Date: Fri, 30 Nov 2012 03:05:00 GMT

[data]

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Fri, 30 Nov 2012 03:05:00 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive

{
    "TFS_FILE_NAME": "T1FOZHB4ET1RCvBVdK.jpg"
}

更新文件

描述

此API用于更新一个已有的TFS文件并以JSON格式返回文件名

语法

PUT /v1/appkey/TfsFileName HTTP/1.1

Host: 10.0.0.1:7500

Content-Length: length

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符，若无使用RcServer，使用tfs即可

请求参数
参数名描述
suffix文件后缀
simple_name是否要求必须带正确后缀才可访问存入的TFS文件
1：要求必须带正确后缀才可访问
0：不带后缀也可访问
应答
名称描述
TFS_FILE_NAME返回的TFS文件名
返回的状态码
HTTP状态码描述
200 OK操作成功
400 Bad Request错误的请求
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey更新TFS文件T1FOZHB4ET1RCvBVdK：

PUT /v1/tfs/T1FOZHB4ET1RCvBVdK HTTP/1.1
Host: 10.0.0.1:7500
Content-Length: 22
Date: Fri, 30 Nov 2012 03:05:00 GMT

[data]

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Fri, 30 Nov 2012 03:05:00 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive

{
    "TFS_FILE_NAME": "T1FOZHB4ET1RCvBVdK"
}

读文件

描述

此API用于从一个TFS文件中读取数据

语法

GET /v1/appkey/TfsFileName HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符，若无使用RcServer，使用tfs即可

TfsFileName是要读取的TFS文件的文件名，可带后缀

请求参数
参数名描述
suffix文件后缀
注：若指定了此参数，并且TfsFileName中也带了后缀，两者不一致将无法访问文件
offset要读取数据在文件在的偏移
size要读取数据的长度
应答
名称描述
data数据
返回的状态码
HTTP状态码描述
200 OK操作成功
400 Bad Request错误的请求
404 Not Found文件不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey读文件T1FOZHB4ET1RCvBVdK：

GET /v1/tfs/T1FOZHB4ET1RCvBVdK HTTP/1.1
Host: 10.0.0.1:7500
Date: Fri, 30 Nov 2012 03:05:00 GMT

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Fri, 30 Nov 2012 03:05:00 GMT
Content-Length: 22
Connection: keep-alive

[data]

下面这个请求，将会使用tfs这个appkey读文件T1FOZHB4ET1RCvBVdK.jpg：

GET /v1/tfs/T1FOZHB4ET1RCvBVdK.jpg HTTP/1.1
Host: 10.0.0.1:7500
Date: Fri, 30 Nov 2012 03:05:00 GMT

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Fri, 30 Nov 2012 03:05:00 GMT
Content-Length: 22
Connection: keep-alive

[data]

删除文件

描述

此API用于将一个TFS文件删除或隐藏

语法

DELETE /v1/appkey/TfsFileName HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符，若无使用RcServer，使用tfs即可

TfsFileName是要读取的TFS文件的文件名，可带后缀

请求参数
参数名描述
suffix文件后缀
注：若指定了此参数，并且TfsFileName中也带了后缀，两者不一致将无法访问文件
hide指定隐藏操作类型：
1：隐藏
0：反隐藏
应答

无

返回的状态码
HTTP状态码描述
200 OK操作成功
400 Bad Request错误的请求
404 Not Found文件不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey删除文件T1FOZHB4ET1RCvBVdK：

DELETE /v1/tfs/T1FOZHB4ET1RCvBVdK HTTP/1.1
Host: 10.0.0.1:7500
Date: Fri, 30 Nov 2012 03:05:00 GMT

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Fri, 30 Nov 2012 03:05:00 GMT
Content-Length: 0
Connection: keep-alive

下面这个请求，将会使用tfs这个appkey隐藏TFS文件T1FOZHB4ET1RCvBVdK.jpg：

DELETE /v1/tfs/T1FOZHB4ET1RCvBVdK.jpg?hide=1 HTTP/1.1
Host: 10.0.0.1:7500
Date: Fri, 30 Nov 2012 03:05:00 GMT

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Fri, 30 Nov 2012 03:05:00 GMT
Content-Length: 0
Connection: keep-alive

获取文件元信息(stat)

描述

此API用于获取一个TFS文件的元信息，将以JSON格式返回

语法

GET /v1/appkey/metadata/TfsFileName HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符，若无使用RcServer，使用tfs即可

TfsFileName是要读取的TFS文件的文件名，可带后缀

请求参数
参数名描述
suffix文件后缀
注：若指定了此参数，并且TfsFileName中也带了后缀，两者不一致将无法访问文件
type是否强制获取：
0：正常获取，若文件被删除或隐藏则无法获取
1：强制获取，即使文件被删除或隐藏也可获取
应答
名称描述
FILE_NAME文件名
BLOCK_ID文件所在block的id
FILE_ID文件的file id
OFFSET文件在其所在block中的偏移
SIZE文件大小
OCCUPY_SIZE文件真正占用空间
MODIFY_TIME文件的最后修改时间
CREATE_TIME文件的创建时间
STATUS文件的状态
0：正常
1：删除
4：隐藏
5: 隐藏且删除
CRC文件的CRC校验码
返回的状态码
HTTP状态码描述
200 OK操作成功
400 Bad Request错误的请求
404 Not Found文件不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey获取文件T1FOZHB4ET1RCvBVdK的元信息：

GET /v1/tfs/metadata/T1FOZHB4ET1RCvBVdK HTTP/1.1
Host: 10.0.0.1:7500
Date: Fri, 30 Nov 2012 03:05:00 GMT

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Fri, 30 Nov 2012 03:05:00 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive

{
    "FILE_NAME": "T1FOZHB4ET1RCvBVdK",
    "BLOCK_ID": 101,
    "FILE_ID": 9223190836479524436,
    "OFFSET": 69563585,
    "SIZE": 103578,
    "OCCUPY_SIZE": 103614,
    "MODIFY_TIME": "Fri, 09 Mar 2012 13:40:32 UTC+0800",
    "CREATE_TIME": "Fri, 09 Mar 2012 13:40:32 UTC+0800",
    "STATUS": 0,
    "CRC": 3208008078
}

自定义文件名

获取APPID

描述

此API用于获取每个TFS应用的appid，以JSON格式返回。每个应用根据自己的appkey，可以获取到一个唯一的appid，这个appid是所有自定义文件名操作所必需的参数。它代表一个应用在TFS中的一个独立的名字空间。

语法

GET /v2/appkey/appid HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符

请求参数

无

应答
名称描述
APP_ID应用的appid
返回的状态码
HTTP状态码描述
200 OK操作成功
400 Bad Request错误的请求
500 Internal Server Error登录失败（未在RcServer数据库中配置应用），或TFS或Nginx服务器内部错误
例子

下面这个请求，将会查询appkey为tfs的应用的appid：

GET /v2/tfs/appid HTTP/1.1
Host: 10.0.0.1:7500
Date: Thu, 28 Jun 2012 08:00:26 GMT

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Thu, 28 Jun 2012 08:00:26 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive

{
    "APP_ID": "1"
}

创建目录(create_dir)

描述

此API用于创建一个目录

语法

POST /v2/appkey/appid/uid/dir/dir_name HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

请求参数
参数名描述
recursive1：递归创建父目录
0：不递归创建父目录
应答

无

返回的状态码
HTTP状态码描述
201 Created创建成功
400 Bad Request目录名不合规范
401 Unauthorized无权限（目前每个应用只对自己的appid下的空间拥有修改权限）
403 Forbidden超过最大子目录数、子文件数或目录深度
409 Conflict目录已存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey在appid为1，uid为1234的名字空间下创建一个/dir_1的目录：

POST /v2/tfs/1/1234/dir/dir_1 HTTP/1.1
Host: 10.0.0.1:7500
Date: Fri, 30 Nov 2012 03:05:00 GMT

对应的应答将会是：

HTTP/1.1 201 Created
Server: Tengine/1.3.0
Date: Wed, 27 Jun 2012 14:59:27 GMT
Content-Length: 0
Connection: keep-alive

删除目录(rm_dir)

描述

此API用于删除一个目录

语法

DELETE /v2/appkey/appid/uid/dir/dir_name HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

请求参数

无

应答

无

返回的状态码
HTTP状态码描述
200 Ok删除成功
400 Bad Request目录/文件名不合规范
401 Unauthorized无权限（目前每个应用只对自己的appid下的空间拥有修改权限）
403 Forbidden目录非空
404 Not Found目录或父目录不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey在appid为1，uid为1234的名字空间下删除/dir_1目录：

DELETE /v2/tfs/1/1234/dir/dir_1 HTTP/1.1
Host: 10.0.0.1:7500
Date: Thu, 28 Jun 2012 08:12:13 GMT

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Thu, 28 Jun 2012 08:12:13 GMT
Content-Length: 0
Connection: keep-alive

移动/重命名目录（mv_dir）

描述

此API用于移动或重命名一个目录

语法

POST /v2/appkey/appid/uid/dir/dest_dir_name HTTP/1.1

Host: 10.0.0.1:7500

Date: date

x-ali-move-source: /src_dir_name

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

此API需要一个特定的header，指定源目录路径

请求参数
参数名描述
recursive1：递归创建目的目录的父目录
0：不递归创建目的目录的父目录
应答

无

返回的状态码
HTTP状态码描述
200 Ok操作成功
400 Bad Request目录/文件名不合规范
401 Unauthorized无权限（目前每个应用只对自己的appid下的空间拥有修改权限）
403 Forbidden移动到子目录中
404 Not Found源目录或父目录不存在，或目的目录已存在，或目的父目录不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey在appid为1，uid为1234的名字空间下将目录/dir_src重命名为/dir_dest：

POST /v2/tfs/1/1234/dir/dir_dest HTTP/1.1
Host: 10.0.0.1:7500
Date: Sat, 30 Jun 2012 05:33:05 GMT
x-ali-move-source: /dir_src

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Sat, 30 Jun 2012 05:33:05 GMT
Content-Length: 0
Connection: keep-alive

列目录（ls_dir）

描述

此API用于列出目录下所有子目录和文件，并以json数组的格式返回。

语法

GET /v2/appkey/metadata/appid/uid/dir/dir_name HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

请求参数

无

应答
名称描述
NAME文件/目录名
PID文件/目录的父目录的id
ID文件/目录的id
SIZE文件的大小
IS_FILE是否是文件
CREATE_TIME文件/目录的创建时间
MODIFY_TIME文件/目录的最后修改时间
VER_NO文件/目录版本号
返回的状态码
HTTP状态码描述
200 Ok操作成功
400 Bad Request目录/文件名不合规范
404 Not Found目录或父目录不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey在appid为1，uid为1234的名字空间下列出目录“/”下的所有子目录和文件：

GET /v2/tfs/metadata/1/1234/dir/ HTTP/1.1
Host: 10.0.0.1:7500
Date: Sat, 30 Jun 2012 05:42:25 GMT

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Sat, 30 Jun 2012 05:42:25 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive

[
    {
        "NAME": "d_0",
        "PID": 635213,
        "ID": 635218,
        "SIZE": 0,
        "IS_FILE": false,
        "CREATE_TIME": "Wed, 27 Jun 2012 10:32:04 UTC+0800",
        "MODIFY_TIME": "Wed, 27 Jun 2012 11:29:30 UTC+0800",
        "VER_NO": 0
    },
    {
        "NAME": "d_3",
        "PID": 635213,
        "ID": 635219,
        "SIZE": 0,
        "IS_FILE": false,
        "CREATE_TIME": "Wed, 27 Jun 2012 10:36:17 UTC+0800",
        "MODIFY_TIME": "Sat, 30 Jun 2012 13:32:53 UTC+0800",
        "VER_NO": 0
    },
    {
        "NAME": "file_1",
        "PID": -9223372036854140595,
        "ID": 0,
        "SIZE": 222,
        "IS_FILE": true,
        "CREATE_TIME": "Wed, 27 Jun 2012 17:13:23 UTC+0800",
        "MODIFY_TIME": "Wed, 27 Jun 2012 17:25:03 UTC+0800",
        "VER_NO": 1
    }
]

查看目录是否存在

描述

此API用于查看指定目录是否存在

语法

HEAD /v2/appkey/appid/uid/dir/dir_name HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

请求参数

无

应答

无

返回的状态码
HTTP状态码描述
200 Ok目录存在
400 Bad Request目录名不合规范
404 Not Found目录不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey在appid为1，uid为1234的名字空间下查看目录“/dir_1”是否存在：

HEAD /v2/tfs/1/1234/dir/dir_1 HTTP/1.1
Host: 10.0.0.1:7500
Date: Sat, 30 Jun 2012 05:42:25 GMT

假如目录存在，对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Sat, 30 Jun 2012 05:42:25 GMT
Content-Length: 0
Connection: keep-alive

创建文件(create_file)

描述

此API用于创建一个文件

语法

POST /v2/appkey/appid/uid/file/file_name HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

请求参数
参数名描述
recursive1：递归创建父目录
0：不递归创建父目录
应答

无

返回的状态码
HTTP状态码描述
201 Created创建成功
400 Bad Request文件名不合规范
401 Unauthorized无权限（目前每个应用只对自己的appid下的空间拥有修改权限）
403 Forbidden超过最大子目录数、子文件数或目录深度
404 Not Found父目录不存在
409 Conflict文件已存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey在appid为1，uid为1234的名字空间下创建一个/file_1的文件：

POST /v2/tfs/1/1234/file/file_1 HTTP/1.1
Host: 10.0.0.1:7500
Date: Fri, 30 Nov 2012 03:05:00 GMT

对应的应答将会是：

HTTP/1.1 201 Created
Server: Tengine/1.3.0
Date: Wed, 27 Jun 2012 14:59:27 GMT
Content-Length: 0
Connection: keep-alive

写文件(write_file)

描述

此API用于向一个文件写数据。自定义文件名支持多次写入，支持pwrite（指定偏移写，可通过offset参数指定偏移量，支持文件空洞），默认为追加写。

注：不支持更新已有数据

语法

PUT /v2/appkey/appid/uid/file/file_name HTTP/1.1

Host: 10.0.0.1:7500

Content-Length: length

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

请求参数
参数名描述
offset要写入的偏移
size要写入的数据长度
应答

无

返回的状态码
HTTP状态码描述
200 Ok操作成功
400 Bad Request文件名不合规范或参数不合法
401 Unauthorized无权限（目前每个应用只对自己的appid下的空间拥有修改权限）
404 Not Found文件不存在
409 Conflict写偏移处已存在数据
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey向appid为1，uid为1234的名字空间下的文件/file_1写入数据：

PUT /v2/tfs/1/1234/file/file_1 HTTP/1.1
Host: 10.0.0.1:7500
Content-Length: 222
Date: Wed, 27 Jun 2012 14:59:27 GMT

[Data]

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Wed, 27 Jun 2012 14:59:27 GMT
Content-Length: 0
Connection: keep-alive

读文件(read_file)

描述

此API用于从一个文件中读数据。

语法

GET /v2/appkey/appid/uid/file/file_name HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

请求参数
参数名描述
offset要读取数据在文件中的偏移
size要读取的数据长度
应答
名称描述
data数据
返回的状态码
HTTP状态码描述
200 Ok操作成功
400 Bad Request文件名不合规范或参数不合法
404 Not Found文件不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey从appid为1，uid为1234的名字空间下读取文件/file_1（整个文件）：

GET /v2/tfs/1/1234/file/file_1 HTTP/1.1
Host: 10.0.0.1:7500
Date: Wed, 27 Jun 2012 14:59:27 GMT

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Wed, 27 Jun 2012 14:59:27 GMT
Content-Length: 222
Connection: keep-alive

[data]

删除文件(rm_file)

描述

此API用于删除一个文件

语法

DELETE /v2/appkey/appid/uid/file/file_name HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

请求参数

无

应答

无

返回的状态码
HTTP状态码描述
200 Ok操作成功
400 Bad Request文件名不合规范
401 Unauthorized无权限（目前每个应用只对自己的appid下的空间拥有修改权限）
404 Not Found文件不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey在appid为1，uid为1234的名字空间下删除/file_1文件：

DELETE /v2/tfs/1/1234/file/file_1 HTTP/1.1
Host: 10.0.0.1:7500
Date: Thu, 28 Jun 2012 08:12:13 GMT

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Thu, 28 Jun 2012 08:12:13 GMT
Content-Length: 0
Connection: keep-alive

移动/重命名文件（mv_file）

描述

此API用于移动或重命名一个文件

语法

POST /v2/appkey/appid/uid/file/dest_file_name HTTP/1.1

Host: 10.0.0.1:7500

Date: date

x-ali-move-source: /src_file_name

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

此API需要一个特定的header，指定要移动或重命名的源文件路径

请求参数
参数名描述
recursive1：递归创建目的文件的父目录
0：不递归创建目的文件的父目录
应答

无

返回的状态码
HTTP状态码描述
200 Ok操作成功
400 Bad Request文件名不合规范或源文件和目的文件相同
401 Unauthorized无权限（目前每个应用只对自己的appid下的空间拥有修改权限）
404 Not Found源文件不存在，或目的文件已存在，或目的文件父目录不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey在appid为1，uid为1234的名字空间下将文件/file_src重命名为/file_dest：

POST /v2/tfs/1/1234/file/file_dest HTTP/1.1
Host: 10.0.0.1:7500
Date: Sat, 30 Jun 2012 05:33:05 GMT
x-ali-move-source: /file_src

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Sat, 30 Jun 2012 05:33:05 GMT
Content-Length: 0
Connection: keep-alive

列文件元信息（ls_file）

描述

此API用于列出文件的元信息

语法

GET /v2/appkey/metadata/appid/uid/file/file_name HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

请求参数

无

应答
名称描述
NAME文件名(绝对路径）
PID文件的父目录的id
ID文件的id
SIZE文件的大小
IS_FILE是否是文件
CREATE_TIME文件的创建时间
MODIFY_TIME文件的最后修改时间
VER_NO文件的版本号
返回的状态码
HTTP状态码描述
200 Ok操作成功
400 Bad Request文件名不合规范
404 Not Found文件不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey在appid为1，uid为1234的名字空间下列出文件“/file_1”的元信息：

GET /v2/tfs/metadata/1/1234/file/file_1 HTTP/1.1
Host: 10.0.0.1:7500
Date: Sat, 30 Jun 2012 05:42:25 GMT

对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Sat, 30 Jun 2012 05:42:25 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive

{
    "NAME": "/file_1",
    "PID": 635213,
    "ID": 0,
    "SIZE": 298481,
    "IS_FILE": true,
    "CREATE_TIME": "Fri, 15 Jun 2012 09:37:39 UTC+0800",
    "MODIFY_TIME": "Sat, 30 Jun 2012 23:57:38 UTC+0800",
    "VER_NO": 0
}

查看文件是否存在

描述

此API用于查看指定文件是否存在

语法

HEAD /v2/appkey/appid/uid/file/file_name HTTP/1.1

Host: 10.0.0.1:7500

Date: date

其中appkey是在RcServer的数据库中配置的应用的标识符

appid是应用的appkey对应的appid，可通过获取APPID的API获得

uid是用户id，每个appid和uid的组合对应一个独立的名字空间，可以认为是appid对应的名字空间下的子空间

请求参数

无

应答

无

返回的状态码
HTTP状态码描述
200 Ok文件存在
400 Bad Request文件名不合规范
404 Not Found文件不存在
500 Internal Server ErrorTFS或Nginx服务器内部错误
例子

下面这个请求，将会使用tfs这个appkey在appid为1，uid为1234的名字空间下查看文件“/file_1”是否存在：

HEAD /v2/tfs/1/1234/file/file_1 HTTP/1.1
Host: 10.0.0.1:7500
Date: Sat, 30 Jun 2012 05:42:25 GMT

假如文件存在，对应的应答将会是：

HTTP/1.1 200 OK
Server: Tengine/1.3.0
Date: Sat, 30 Jun 2012 05:42:25 GMT
Content-Length: 0
Connection: keep-alive
sdbzwangdongdong
关注
TFS(taobao file system淘宝文件系统)RestFul API 试用总结
03-11 3453
刚试用了下淘宝自己开发的文件系统TFS，感觉基于nginx做的RESTful API用起来还是挺方便的，下面对这些API简单总结下，也说下我的一些经验： 特别是那些觉得搭PHP环境的很麻烦的朋友不访参考下我的方案二。 nginx_ip为nginx客户端的ip，port为nginx web服务接口。 一.得用restful api(详细可以参考淘宝的github)     1
TFS JavaAPI源码(附带JUinit测试用例)
08-03
这个压缩包包含的文件名为“tfs”，很可能是包含了整个TFS Java API的源代码库，包括核心的API类、工具类以及相关的配置文件。对于开发者来说，查看和理解源码是非常重要的，因为它可以帮助我们了解如何与TFS进行...
TFS API 文档
04-14
很实用的TFS API，chm格式的，方便查阅
tfs操作图片，及小图片
yuhui666666的博客
08-23 268
tfs操作图片，及小图片 tfs 保存后会返回新的文件名（可以控制为原文件名），后面是通过这个文件名获取，tfs传进去存储的都是在一个默认的根文件夹中，所有的文件通过hash索引查，我们保存数据库 可以拼接一些虚拟的业务路劲   示例中包括，保存进tfs,同时把小图保存在tfs    public static String lessImageTfs(String inPath, S...
TFS Restful API
ronon77的专栏
04-24 470
  1. Restful简介：        Restful的一个思想就是充分利用http的特性，将资源独立出来，并对资源可以有各种操作。比如http标准的get/put/delete/post/header/option等。          一般来说，get/put/delete是等幂的操作，也就是说，相同的多次操作，原则上是不应该影响到最终结果的。而post则多用于添加一个新的资...
FastDFS入门，从零搭建一个图片服务器
weixin_47773556的博客
05-10 221
最近开发的项目中需要使用到 FastDFS，因此抽时间进行了学习，进行了总结 FastDFS 分布式文件系统 FastDFS是淘宝的余庆所开发的，是一款开源的轻量级分布式文件系统，采用纯C实现，目前提供了C,JAVA和PHP的API，主要用它来对文件进行管理，功能包括：文件存储、文件同步、文件访问（文件上传、文件下载）等，解决了大容量存储和负载均衡的问题。同类的分布式文件系统有谷歌的GFS,HDFS,TFS等。 FastDFS服务端有两个角色：跟踪器（tracker）和存储节点（storage）。 跟踪器主
TFS：通过REST接口驱动TFS 2015+的Powershell模块
01-30
【TFS：通过REST接口驱动TFS 2015+的Powershell模块】是一个专注于利用RESTful API与PowerShell结合，实现对Team Foundation Server（TFS）2015及更高版本进行自动化操作的技术主题。在现代的DevOps环境中，这样的...
tfs 2.4.3 及 nginx-tfs 编译安装
08-12
### TFS 2.4.3及nginx-tfs编译安装相关知识点 #### 一、TFS 2.4.3编译安装流程 **1. GCC降级** - **原因**: 某些软件可能对GCC版本有特定的要求，以确保编译过程顺利进行。在本案例中，由于TFS 2.4.3的编译需求，...
VersionOne.Integration.TFS.Listener:用于集成的VersionOne.Integration.TFS.Listener组件
05-16
安装和配置过程中，用户需要提供TFS服务器的连接信息、认证凭据以及VersionOne的API访问凭证。一旦设置完成，组件就能自动处理后续的集成工作，减轻团队成员手动同步数据的负担。 此外，由于该组件是开源的，开发...
微软tfs sdk + 说明文档
08-28
微软tfs sdk + 说明文档
TFS使用文档说明
11-12
TFS（Team Foundation Server）是一个高可扩展、高可用、高性能、面向互联网服务的分布式文件系统，主要针对海量的非结构化数据，它构筑在普通的Linux机器集群上，可为外部提供高可靠和高并发的存储访问。TFS为淘宝提供海量小文件存储，通常文件大小不超过1M，满足了淘宝对小文件存储的需求，被广泛地应用在淘宝各项应用中。它采用了HA架构和平滑扩容，保证了整个文件系统的可用性和扩展性。同时扁平化的数据组织结构，可将文件名映射到文件的物理地址，简化了文件的访问流程，一定程度上为TFS提供了良好的读写性能。
TFSRestful接口测试总结分享
01-31
近期刚刚完成Nginx版本的TFS（TaobaoFileSystem） Restful接口测试工作，借此契机总结分享以下3点：1、Restufl简介；2、TFSRestful接口设计思路；3、TFS Restful接口开发过程中容易出现的bug分析（重点介绍）解决方案：1、Restful简介：Restful的一个思想就是充分利用http的特性，将资源独立出来，并对资源可以有各种操作。比如http标准的get/put/delete/post/header/option等。
TFS API使用
angmangz75888的博客
05-02 359
最近安装了TFS2010进行代码管理，感觉比SVN好用点! Creating a Build Definition using the TFS 2010 API In this post I will show how to create a new build definition in TFS 2010 using the TFS API. When creating a ...
TFS RESTful API 模拟上传测试
ronon77的专栏
04-27 338
       TFS RESTful API 模拟上传测试。 　　 细节参看这里：https://github.com/alibaba/nginx-tfs/blob/master/TFS_RESTful_API.markdown 模拟POST上传一个图片： curl --data-binary @/opt/tfs.png http://192.168.10.218:7500/v1/tf...
TFS文件编码检查机制和修改（Team Foundation Server 2013）
weixin_30955617的博客
01-27 173
TFS的版本控制系统会自动按照下面的标准检测代码文件的编码格式： 1. 首先，如果代码文件包含了BOM部分，则使用BOM中制定的编码格式打开文档 什么是BOM (Byte order mark)？ http://en.wikipedia.org/wiki/Byte_order_mark 2. 如果代码文件没有BOM部分，TFS检测第一个千字节中的不可打印ASCII字符（unprintable...
TFS 代码 API
学无止境，享受学习。--weixiao
02-10 1278
获取TFS C++客户端 TFS C++ 客户端库包含一些头文件和一个libtfsclient.so的共享库文件。 可以直接通过编译源码获取。 TFS C++客户端使用说明 Tfs客户端提供了TfsClient类作为TFS文件操作的接口。类TfsClient在使用前需要初始化，初始化完成之后就可以多次打开不同的Tfs文件，对它们进行读写。Tfs客户端提供了打开/关闭、读/写、删除
基于微信小程序的新生报到系统设计与实现.docx
最新发布
09-13
基于微信小程序的新生报到系统设计与实现.docx
TFS2012单服务器安装指南
"该资源提供了Team Foundation Server (TFS) 2012的安装步骤，包括单服务器安装的详细过程、客户端安装以及权限设置。文章涵盖了安装环境配置、SQL Server 2008/2012的准备与设置、防火墙配置、Team Foundation ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值