POST http://{Endpoint}/oss/v1.0/bucket

创建桶是按照用户指定的桶名创建一个新桶。

1. 请求示例

POST http://{Endpoint}/oss/v1.0/bucket

{

     "BucketName": "myBucket",

     "Region": "wuhan",

     "StorageType": "STANDARD",

     "AccessControlType": "private"

}

2. 正常返回示例

HTTP/1.1 200OK

Content-Type：application/json

{

    "RequestId": " c9d0bc5a82ca0bb2c320995cfe31f***",

    "BucketName": " myBucket ",

    "ResourceId ": "myId"

}

DELETE http://{Endpoint}/oss/v1.0/bucket

删除桶操作用于删除用户指定的桶。只有桶的所有者或者拥有桶的删除桶 policy 权限的用户可以执行删除桶的操作，要删除的桶必须是空桶。

1. 请求示例

DELETE http://{Endpoint}/oss/v1.0/bucket

{

     "BucketName": "myBucket"

}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type：application/json

{

    "RequestId": " c9d0bc5a82ca0bb2c320995cfe31f***",

    "BucketName": " myBucket ",

    "ResourceId": "myId"

}

GET http://{Endpoint}/oss/v1.0/bucketExists/{BukcetName}

所有用户都可以用此请求判断桶是否已经存在。

无需 body 参数，请求 URL 中可直接访问。

1. 请求示例

GET http://{Endpoint}/oss/v1.0/bucketExists/{myBukcet}

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json 

{

    "RequestId": "c9d0bc5a82ca0bb2c320995cfe31f***",

    "IsSuccess": true

}

GET http://{Endpoint}/oss/v1.0/bucket/{BukcetName}

桶所有者可以执行该请求查询桶元数据。

无需 body 参数，请求 URL 中可直接访问。

1. 请求示例

GET http://{Endpoint}/oss/v1.0/bucket/myBucket

2. 正常返回示例

HTTP/1.1 200 OK

Content-Type:application/json 

{

    "RequestId": "c9d0bc5a82ca0bb2c320995cfe31f***"

    "Storage": 10000,

    "ObjectNum": 23,

    "AccessControlType": "private",

    "TenantId": "mycode",

    "RegionId": "wuhan",

    "CreatedAt": "yyyy-MM-dd HH:mm:ss",

    "ResourceId": "myId"

}