前缀列表查询 - 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
       }
    ]
}