前缀列表查询

SDK 提供PrefixFileList方法用于前缀列表查询，完整代码详见Github。

PrefixFileList方法请求的 US3 API 为 PrefixFileList，具体详见PrefixFileList API文档。

参数说明

参数名	类型	说明
Prefix	string	返回以Prefix作为前缀的目录文件列表，为""时默认全匹配
Marker	string	返回以字母排序后，大于Marker的目录文件列表
Limit	int	指定返回目录文件列表的最大数量，传入 0 时会默认设置为 20，不可大于1000

获取指定前缀的所有文件

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
package main

import (
	ufsdk "github.com/ufilesdk-dev/ufile-gosdk"
	"log"
)

const (
	ConfigFile = "config.json"
	Prefix = ""
	Marker = ""
)

func main() {

	// 加载配置，创建请求
	config, err := ufsdk.LoadConfig(ConfigFile)
	if err != nil {
		panic(err.Error())
	}
	req, err := ufsdk.NewFileRequest(config, nil)
	if err != nil {
		panic(err.Error())
	}
	marker := Marker
	prefix := Prefix

	// fileList 存储查询的全部文件列表信息
	var fileList ufsdk.FileListResponse
	for ;; {
		list, err := req.PrefixFileList(prefix, marker , 0)
		if err != nil {
			log.Fatalf("前缀列表查询失败，错误信息为：%s", err.Error())
		}
		fileList.DataSet = append(fileList.DataSet, list.DataSet...)
		if len(list.DataSet) == 0 || len(list.NextMarker) <= 0{
			break
		}
		marker = list.NextMarker
	}
	log.Printf("前缀列表查询成功, 文件列表长度为 %d", len(fileList.DataSet))
}

获取指定限制数量的文件列表

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
package main

import (
	ufsdk "github.com/ufilesdk-dev/ufile-gosdk"
	"log"
)

const (
	ConfigFile = "config.json"
	Marker = ""
	Limit = 1500
)

func main() {

	// 加载配置，创建请求
	config, err := ufsdk.LoadConfig(ConfigFile)
	if err != nil {
		panic(err.Error())
	}
	req, err := ufsdk.NewFileRequest(config, nil)
	if err != nil {
		panic(err.Error())
	}
	marker := Marker
	limit := Limit

	// fileList 存储查询的全部文件列表信息
	var fileList ufsdk.FileListResponse
	for {
		list, err := req.PrefixFileList("", marker, 0)
		if err != nil {
			log.Fatalf("前缀列表查询失败，错误信息为：%s", err.Error())
		}
		if len(list.DataSet) >= limit {
			fileList.DataSet = append(fileList.DataSet, list.DataSet[:limit]...)
			break
		}
		fileList.DataSet = append(fileList.DataSet, list.DataSet...)
		limit = limit - len(list.DataSet)
		if len(list.NextMarker) <= 0 {
			break
		}
		marker = list.NextMarker
	}
	log.Printf("前缀列表查询成功, 文件列表长度为 %d", len(fileList.DataSet))
}

获取指定Marker之后的所有文件

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
package main

import (
	ufsdk "github.com/ufilesdk-dev/ufile-gosdk"
	"log"
)

const (
	ConfigFile = "config.json"
	Marker = ""
)

func main() {

	// 加载配置，创建请求
	config, err := ufsdk.LoadConfig(ConfigFile)
	if err != nil {
		panic(err.Error())
	}
	req, err := ufsdk.NewFileRequest(config, nil)
	if err != nil {
		panic(err.Error())
	}
	marker := Marker

	// fileList 存储列举的全部文件信息
	var fileList ufsdk.FileListResponse
	for ;; {
		list, err := req.PrefixFileList("", marker, 0)
		if err != nil {
			log.Fatalf("前缀列表查询失败，错误信息为：%s", err.Error())
		}
		fileList.DataSet = append(fileList.DataSet, list.DataSet...)
		if len(list.NextMarker) <= 0{
			break
		}
		marker = list.NextMarker
	}
	log.Printf("前缀列表查询成功, 文件列表长度为 %d", len(fileList.DataSet))
}

获取指定前缀、指定Marker之后、指定限制数量的文件列表

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
package main

import (
	ufsdk "github.com/ufilesdk-dev/ufile-gosdk"
	"log"
)

const (
	ConfigFile = "config.json"
	Prefix = ""
	Marker = ""
	Limit = 1500
)

func main() {

	// 加载配置，创建请求
	config, err := ufsdk.LoadConfig(ConfigFile)
	if err != nil {
		panic(err.Error())
	}
	req, err := ufsdk.NewFileRequest(config, nil)
	if err != nil {
		panic(err.Error())
	}
	prefix := Prefix
	marker := Marker
	limit := Limit

	// fileList 存储列举的全部目录文件信息
	var fileList ufsdk.FileListResponse
	for ;; {
		list, err := req.PrefixFileList(prefix, marker, 0)
		if err != nil {
			log.Fatalf("前缀列表查询失败，错误信息为：%s", err.Error())
		}
		if len(list.DataSet) >= limit {
			fileList.DataSet = append(fileList.DataSet, list.DataSet[:limit]...)
			break
		}
		fileList.DataSet = append(fileList.DataSet, list.DataSet...)
		limit = limit - len(list.DataSet)
		if len(list.NextMarker) <= 0 {
			break
		}
		marker = list.NextMarker
	}
	log.Printf("前缀列表查询成功, 文件列表长度为 %d", len(fileList.DataSet))
}

错误码

HTTP 状态码	RetCode	ErrMsg	描述
400	-148653	bucket not exists	存储空间不存在
400	-15036	check md5 failed	MD5校验失败
401	-148643	no authorization found	上传凭证错误
403	-148643	invalid signature	API公私钥错误
400	-15005	invalid limit:xxx	limit 取值范围 [0, 10000]

PREVIOUS获取文件基本信息

NEXT获取目录文件列表