You can call this operation to create a bucket.

Usage notes

When you call the PutBucket operation, take note of the following items:

  • Anonymous access is not supported.
  • You can use an Alibaba Cloud account to create up to 100 buckets in the same region.
  • Each region has corresponding endpoints. For more information about the mappings between regions and endpoints, see Regions and endpoints.

Request structure

PUT / HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
x-oss-acl: Permission
Authorization: SignatureValue
<? xml version="1.0" encoding="UTF-8"? >
<CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>

Request headers

Header Type Required Description
x-oss-acl String No The access control list (ACL) for a bucket. Default value: private.

Valid values:

  • public-read-write
  • public-read
  • private

For more information about the ACL for buckets, see Set the ACL for a bucket.

Request elements

Element Type Required Description
StorageClass String No The storage class of the bucket. Default value: Standard.
Valid values:
  • Standard
  • IA (Infrequent Access)
  • Archive
  • ColdArchive
DataRedundancyType String No

The type of disaster recovery for a bucket. Default value: LRS.

Valid values:
  • LRS

    If you specify LRS, OSS stores the copies of each object across different devices within the same zone. This way, OSS ensures data reliability and availability in case of hardware failures.

  • ZRS

    Zone-redundant storage (ZRS) uses the multi-zone(AZ) mechanism to distribute user data across three zones within the same region. Even if one zone becomes unavailable due to failures such as power outages and fires, the data is still accessible.

Note For more information about the type of disaster recovery, see Overview.

Examples

Sample requests
PUT / HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2017 03:15:40 GMT
x-oss-acl: private
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:77Dvh5wQgIjWjwO/KyRt8dOP****
<? xml version="1.0" encoding="UTF-8"? >
<CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>
Sample responses
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2017 03:15:40 GMT
Location: /oss-example
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

SDK

The SDKs of the PutBucket operation for various programming languages:

Error codes

Error code HTTP status code Description
InvalidBucketName 400 The error message returned because the bucket name does not comply with the naming conventions.
AccessDenied 403
  • The error message returned because the information for user authentication is not imported when you initiate a PutBucket request.
  • The error message returned because you are not authorized to query the ACL of the bucket.
TooManyBuckets 400 The error message returned because the number of buckets to be created exceeds the upper limit. You can use an Alibaba Cloud account to create up to 100 buckets in the same region.