Bucket相关接口

GetBucketLocation接口

接口描述

获取Bucket所在的区域。

请求(Request)

  • 请求语法

    GET /?location HTTP/1.1
    Host: <BucketName>.bj.bcebos.com
    Date: <Date>
    Authorization: <Authorization_String>
    Content-Length: 0
    
  • 请求头域

    无特殊参数

  • 请求参数

    无特殊参数

响应(Response)

  • 响应头域

    无特殊Header参数响应

  • 响应元素

名称 类型 描述
location String Bucket所在区域

示例

  • 请求示例

    GET /?location HTTP/1.1
    Host: BucketName.bj.bcebos.com
    Date: Wed, 06 Apr 2016 06:34:40 GMT
    Authorization: AuthorizationString
    Content-Length: 0
    
  • 响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
    Date: Wed, 06 Apr 2016 06:34:40 GMT
    Content-Length: 35
    Connection: close
    Server: BceBos
    
    {
        "locationConstraint": "bj"
    }
    

ListBuckets接口

接口描述

列举请求者拥有的所有bucket。

请求(Request)

  • 请求语法

    GET / HTTP/1.1
    Host: <BucketName>.bj.bcebos.com
    Date: <Date>
    Authorization: <Authorization_String>
    
  • 请求头域

    无特殊参数

  • 请求参数

    无特殊参数

响应(Response)

  • 响应头域

    无特殊Header参数响应

  • 响应元素

名称 类型 描述
owner Object Bucket owner(拥有者)信息
+id String Bucket owner的用户id
+displayName String Bucket owner的名称
buckets Object 存放多个bucket信息的容器
bucket Object 存放一个bucket信息的容器
+name String Bucket名称
+location String Bucket所在区域
+creationDate Date Bucket创建时间

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