You can call this operation to create a bucket.
Usage notes
- To create a bucket, you must have the PutBucket permission.
- You can create up to 100 buckets in the same region by using an Alibaba Cloud account.
- Each region can be accessed by using the endpoints of the region. For more information about regions and their 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 | Example | Description |
---|---|---|---|---|
x-oss-acl | String | No | private | The access control list (ACL) of the bucket that you want to create. Valid values:
For more information about how to configure bucket ACLs, see Set the ACL for a bucket. |
x-oss-hns-status | String | No | enabled | Specifies whether to enable the hierarchical namespace feature for the bucket you
want to create. Default value: disabled.
You can enable or disable the hierarchical namespace feature for a bucket only when you create the bucket. The hierarchical namespace feature cannot be enabled or disabled for an existing bucket.
|
For more information about other common request headers that are used in this API operation, see Common request headers.
Request elements
Element | Type | Required | Example | Description |
---|---|---|---|---|
StorageClass | String | No | Standard | The storage class of the bucket. Default value: Standard.
Valid values:
|
DataRedundancyType | String | No | LRS |
The disaster recovery type of a bucket. Default value: LRS. Valid values:
|
For more information about the storage classes and disaster recovery types of buckets, see Overview.
Response headers
The response to a PutBucket request contains only common response headers. For more information, see Common response headers.
Examples
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>
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2017 03:15:40 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
SDK
You can use OSS SDKs for the following programming languages to call the PutBucket operation:
Error codes
Error code | HTTP status code | Description |
---|---|---|
InvalidBucketName | 400 | The error message returned because the bucket name does not conform to the naming conventions. |
AccessDenied | 403 | Possible causes:
|
TooManyBuckets | 400 | The error message returned because the number of buckets that you want to create exceeds the upper limit. You can create up to 100 buckets in the same region by using an Alibaba Cloud account. |
BucketAlreadyExists | 409 | Possible causes:
|