Skip to content
大纲

ListBuckets

接口描述

本接口列举了请求者拥有的所有bucket。

请求(Request)

请求语法

GET / HTTP/1.1
Host: fos.flymeyun.com
Date: <Date>

请求头域

无特殊参数

请求参数

无特殊参数

响应(Response)

响应头域

无特殊Header参数响应

响应元素

名称类型描述
ownerObjectBucket 租户信息
+idStringBucket 租户CODE 和 租户ID 组成的字符串,组合规则 "{租户CODE}-{租户ID}"
+displayNameStringBucket 租户CODE 和 租户ID 组成的字符串,组合规则 "{租户CODE}-{租户ID}"
bucketsArray存放多个bucket信息的容器
+bucketObject存放一个bucket信息的容器
+nameStringBucket名称
+creationDateDateBucket创建时间

注意: 如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied。

示例

JSON请求示例

说明:一次请求最多返回100个bucket的信息。

json
GET / HTTP/1.1
Host: fos.flymeyun.com
Date: Wed, 06 Apr 2016 06:34:40 GMT

JSON请求响应示例

json
{
  "owner": {
    "id": "Flyme-xxxxxxx",
    "displayName": "Flyme-xxxxxxx"
  },
  "buckets": [
    {
      "name": "bucket1",
      "creationDate": "2016-04-05T10:20:35Z"
    },
    {
      "name": "bucket2",
      "creationDate": "2016-04-05T16:41:58Z"
    }
  ]
}

说明: JSON请求响应项的命名规则是首字母小写的驼峰格式。