百度智能云

All Product Document

          Object Storage

          List Storage Buckets

          Interface Description

          This interface lists all buckets owned by the requester.

          Notes

          1. When no user verification information is available in the request, the system returns 403 Forbidden, error information:AccessDenied.
          2. The naming convention of the JSON request response item is in the lower camel case.
          3. In a request, the system can return the information of up to 100 buckets.

          Request URI

          GET /v1

          Request Body Parameters

          Description of Data Structure for Request Body Field

          Response Body Parameters

          Description of Data Structure for Response Body Field

          Parameter Name Parameter Type Description Example Value
          owner Owner Bucket owner information
          buckets List Container for storing multiple bucket messages

          Description of Data Structure for Owner Field

          Parameter Name Parameter Type Description Example Value
          id String Bucket owner ID 10eb6f5ff6ff4605bf044313e8f3ffa5
          displayName String Name of the bucket owner BosUser

          Description of Data Structure for Buckets Field

          Parameter Name Parameter Type Description Example Value
          name String Bucket name bucket2
          location String The region where the bucket resides. bj
          creationDate String Bucket creation date 2016-04-05T16:41:58Z
          enableMultiAz Boolean Whether the bucket data is distributed in multiple AZs. If it is a non-multi-AZ bucket, do not return this attribute. true

          Request Example

          GET /v1
          Common Request Header
          
          
          { }

          Response Example

          HTTP/1.1 200 OK
          <Common response header>
          
          {
            "owner" : {
              "displayName" : "BosUser",
              "id" : "10eb6f5ff6ff4605bf044313e8f3ffa5"
            },
            "buckets" : [ {
              "name" : "bucket2",
              "location" : "bj",
              "creationDate" : "2016-04-05T16:41:58Z",
              "enableMultiAz" : true
            }, {
              "name" : "bucket2",
              "location" : "bj",
              "creationDate" : "2016-04-05T16:41:58Z",
              "enableMultiAz" : true
            } ]
          }

          Error Code

          Refer to the universal error code.

          Previous
          Object Related Interfaces
          Next
          Quota Management