Create bucket

Updated at：2025-11-03

Overview

Once the BOS service is activated, users can start utilizing object storage in BOS. The first step is to create a storage container, called a bucket.

Note

A bucket is region-specific and must belong to one designated region. Since the bucket's name and its region cannot be changed after creation, it’s recommended to select a region close to your business operations to enhance upload/download efficiency and improve access speeds.
Each user can create a maximum of 100 buckets.
If you have enabled multi-region services, please select the region where the bucket is located as needed. For reference, see [Region Selection Instructions](Reference/Region Selection Instructions/Region.md).
You can select the default storage class of the bucket when creating it. If the storage class of an object uploaded by the user using API, CLI, or SDK is not specified, it will inherit the default storage class of the bucket. On the management console, the uploaded object is by default of standard storage class. If the storage class of the object differs from the storage class of the bucket, the storage class of the object shall apply. Storage classes include standard storage, infrequent access storage, cold storage, and archive storage. For specific usage scenarios and performance, refer to Tiered Storage.
Bucket names must be globally unique. To ensure uniqueness, you can use a prefix such as your organization’s name. Once a bucket is created, its name cannot be modified.
Corresponding read-write permissions can be set when creating a bucket, including three types: private, public-read, and public-read-write. If you need to set advanced permissions, please create the bucket first and then set them in the corresponding Details page. For specific content, please refer to [bucket permission control](BOS/Developer Guide/Data Security/Permission control/Bucket permission control.md).

Use management console to create a bucket

Sign in to the Baidu AI Cloud Object Storage (BOS) Management Console.
In the left navigation bar of the console, find the bucket list and click the +button (Create Bucket button), then follow the prompts in the pop-up box to create a bucket.

Configuration items	Configuration description
Bucket name	The name of each bucket is globally unique. You can use a prefix to ensure the uniqueness of the name, such as using the name of the organization you belong to as the prefix of the bucket. Once a bucket is created, its name cannot be changed. Bucket names can only contain lowercase letters, numbers, and hyphens ("-"), shall start and end with lowercase letters or numbers, and shall be between 4-63 characters in length.
Region	A bucket has a regional attribute and can only be located in one region. Since the region it belongs to cannot be modified after bucket name creation, it is recommended to store it nearby according to service conditions to facilitate upload and download and improve access speed. If you have enabled multi-region services, please select the region where the bucket is located as needed. For reference, see Region Selection Instructions.
Default storage class	When creating a bucket, you can select its default storage class. If the object uploaded via API, CLI, or SDK does not have a specified storage class, it follows the default storage class of the bucket. On the console, the uploaded object is by default of standard storage class. When the storage class of the object differs from the storage class of the bucket, the storage class of the object shall apply. Storage classes include standard storage, infrequent access storage, cold storage, and archive storage. For specific usage scenarios and performance, refer to Tiered Storage.
Read-write permissions	Private: The bucket creator has full exclusive permission to the bucket. Others cannot write data to or read from the bucket. Suitable for storing confidential files. Public-read: The bucket creator has full exclusive permission to the bucket. Others can read its contents but cannot write data to it. Suitable for storing files requiring public access, such as notifications or advertisements. Please note that enabling this permission allows all internet users to access and read files in the bucket. Please enable it with caution. Public-read-write: Anyone, including the bucket creator, can access and write files. Please note that enabling this permission allows all internet users to read and write files in the bucket. Please enable it with caution. If you need to set advanced permissions, you need to modify the corresponding permission settings after creating the bucket. For details, please refer to Update Bucket Permissions.
CDN official acceleration	After enabling the Official CDN Acceleration for the bucket, the DNS resolution of the corresponding bucket domain name will be modified to the CNAME domain name provided by CDN, so as to access the CDN nodes and enable CDN acceleration. By default, official CDN acceleration is enabled when creating a bucket. If you need to disable it, you can directly set “Official CDN Acceleration” to “OFF” during the creation process.
Tag binding	You can bind a bucket to a tag according to project and scenario requirements, making it easier to classify, identify, and manage buckets. Before binding tags, you need to create tags on the console first.
Other descriptions	Each user can create up to 100 buckets. Please create them judiciously. If the count of buckets you created has reached the limit, please delete the bucket after clearing the files within it; otherwise, the bucket cannot be deleted. New buckets can be created only after the existing buckets are deleted. No fees will be incurred immediately after a bucket is created. Billing for storage space occupied by files in a bucket only begins after files are stored in the bucket.

After clicking OK, the bucket is created successfully. Next, you can upload files to the bucket.

Create a bucket by the API

API: [PutBucket](BOS/API Reference/Bucket-Related Interface/Basic Operations/PutBucket.md).

Create a bucket by using SDK

JAVA SDK: [Create Bucket](BOS/SDK/Java-SDK/Bucket management/Create Bucket.md)
Python SDK: [Create Bucket](BOS/SDK/Python-SDK/Bucket management/Create Bucket.md)
PHP SDK: [Create Bucket](BOS/SDK/PHP-SDK/Bucket management.md#Create Bucket)
C# SDK: [Create Bucket](BOS/SDK/C-Dotnet-SDK/Bucket management.md#Create Bucket)
JavaScript SDK: [Create Bucket](BOS/SDK/JavaScript-SDK/Bucket management.md#Create Bucket)
Android SDK: [Create Bucket](BOS/SDK/Android-SDK/Bucket management/Create Bucket.md)
iOS SDK: [Create Bucket](BOS/SDK/IOS-SDK/Bucket management/Create New Bucket.md)
Ruby SDK: [Create Bucket](BOS/SDK/Ruby-SDK/Bucket management/Create Bucket.md)
Go SDK: [Create Bucket](BOS/SDK/GO-SDK/Bucket management.md#Create Bucket)
C++ SDK: [Create Bucket](BOS/SDK/C++-SDK/Bucket management/Create Bucket.md)

Video Zone

Get Object