Interface Description

This interface lists all buckets owned by the requester.

Request

• Request syntax

  GET / HTTP/1.1
  Host: bj.bcebos.com
  Date: <Date>
  Authorization: <AuthorizationString>

• Request header field

  No special parameters.

• Request parameters

  No special parameters.

Response

• Response header field

  No special Head parameter response

• Response element

  Name	Type	Description
  owner	Object	Bucket owner information
  +id	String	Bucket owner ID
  +displayName	String	Name of bucket owner
  buckets	Array	Container for storing multiple bucket messages
  bucket	Object	Container for storing multiple bucket messages
  +name	String	Bucket name
  +location	String	The region where the bucket resides.
  +creationDate	Date	Bucket creation date

  Note: When no user verification information is available in the request, return 403 Forbidden, error information:AccessDenied.

Example

• JSON request example

  Description: A request can return up to 100 bucket messages.

  GET / HTTP/1.1
  Host: bj.bcebos.com
  Date: Wed, 06 Apr 2016 06:34:40 GMT
  Authorization: <AuthorizationString>

• JSON request response example

  {
      "owner":{
          "id":"10eb6f5ff6ff4605bf044313e8f3ffa5",
          "displayName":"BosUser"
      },
      "buckets":[
          {
              "name":"bucket1",
              "location":"bj",
              "creationDate":"2016-04-05T10:20:35Z"
          },
          {
              "name":"bucket2",
              "location":"bj",
              "creationDate":"2016-04-05T16:41:58Z"
          }
      ]
  }

Descriptions: The naming convention of the JSON request response item is the lower camel case.