前缀列表查询 - PrefixFileList

简介

获取Bucket中指定文件前缀的文件列表

定义

句法（Syntax）:


GET /?list&prefix=<prefix>&marker=<marker>&limit=<limit>
Host: <bucket_name>.ufile.ucloud.cn
Authorization: <token>

请求参数（Request Parameters）

请求头（Request Headers）

Name	Type	Description	Required
prefix	String	前缀，utf-8编码，默认为空字符串	No
marker	String	标志字符串，utf-8编码，默认为空字符串)	No
limit	Integer	文件列表数目，默认为20	No
Authorization	String	下载请求的授权签名，API 签名算法	No

请求元素（Request Elements）

说明: 未使用。

响应（Responses）

响应头（Response Headers）

Name	Type	Description
BucketName	String	Bucket的名称
BucketId	String	Bucket的ID
NextMarker	String	下一个标志字符串，utf-8编码
DataSet	Array	文件列表

DataSet Item

Name	Type	Description
BucketName	String	文件所属Bucket名称
ObjectName	String	文件名称,utf-8编码
Hash	String	文件hash值
MimeType	Array	文件mimetype
Size	Integer	文件大小
CreateTime	Integer	文件创建时间
ModifyTime	Integer	文件修改时间
StorageClass	String	文件存储类型，分别是标准、低频、归档，对应有效值：STANDARD, IA, ARCHIVE

示例

请求示例（Example Request）:


GET /?list&prefix=aaa
Host: blue.ufile.ucloud.cn
Authorization:  demouser@ucloud.cn13424346821929713944:S5FVD2w613MKb/hisjaqHdjvn9U=

响应示例（Example Response）:


{
    "BucketName": "blue",
    "BucketId": "ufile-qs20fr",
    "NextMarker": "",
    "DataSet": [
        {
            "BucketName": "blue",
            "ObjectName": "aaa.jpg",
            "Hash": "fbfc1aba39fdac0e0f298461970529d3",
            "MimeType": "image/jpeg",
            "Size": 344500,
            "CreateTime": 1408298579,
            "ModifyTime": 1408298579
       }
    ]
}