帮助与文档

我们为你提供丰富、详尽的使用指南以及产品文档

GET Bucket (List Objects)

获取存储空间中的对象(object)列表。此 API 需要调用者对 bucket 有读权限。

注解

获取存储空间列表请见 GET Service

Request Syntax

GET / HTTP/1.1
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

Request Parameters

Parameter name Type Description Required
prefix String 限定返回的 object key 必须以 prefix 作为前缀 No
delimiter Char 是一个用于对 Object 名字进行分组的字符。所有名字包含指定的前缀且第一次出现 delimiter 字符之间的 object 作为一组元素 No
marker String 设定结果从 marker 之后按字母排序的第一个开始返回 No
limit Integer 限定此次返回 object 的最大数量,默认值为 200,最大允许设置 1000 No

Request Headers

参见公共请求头

Request Elements

没有请求消息体

Response Headers

参见公共响应头

Response Elements

Name Type Description
name String 存储空间的名称
owner String 存储空间的所有者
common_prefixes String 如果请求中指定了 delimiter 参数 , 则响应中包含该元素,用来标明那些以 delimiter 结尾,并有共同前缀的对象名称的集合
prefix String 如果请求中指定了 prefix 参数 , 则响应中包含该元素
next_marker String 本次返回列表里的最后一个 key , 加载更多时用来指定从哪里开始
marker String 当前返回与 next_marker 相同,兼容期结束将修改为与请求参数 marker 相同
keys List 匹配的对象元信息列表
key String 对象名称
size Integer 对象大小
etag Hex 对象内容的唯一标示 (该值会使用双引号括起来)
mime_type String 对象类型
created Date 对象创建时间
modified Int 对象修改时间
encrypted Boolean 对象是否加密

Example

Example Request

GET /?delimiter=/&limit=4 HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
Authorization: authorization string

Example Response

HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 16 Aug 2015 09:05:00 GMT
Content-Length: 559
Connection: close
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b

{
  "name": "mybucket",
  "keys": [
    {
      "created": "2016-08-22T15:03:32.000Z",
      "modified": 1471878212,
      "encrypted": true,
      "etag": "\"4f44b10f5cb83777fea4ef88a3f7b3c4\"",
      "key": "api.txt",
      "mime_type": "text/plain",
      "size": 38970
    },
    {
      "created": "2016-08-22T15:09:52.000Z",
      "modified": 1471878592,
      "encrypted": false,
      "etag": "\"9f1cd921dbb6656c2c9e57f83f73d70e\"",
      "key": "bigtable-osdi06.pdf",
      "mime_type": "application/pdf",
      "size": 221214
    }
  ],
  "prefix": "",
  "owner": {
    "id": "usr-DxWdNcCr",
    "name": "william"
  },
  "delimiter": "/",
  "limit": 4,
  "marker": "",
  "next_marker": "bigtable-osdi06.pdf",
  "common_prefixes": [
    "QCI/",
    "Screenshot/"
  ]
}