Create bucket
Updated at:2025-11-03
Overview
In BOS, the basic data unit for user operations is an object, and every object must be stored within a bucket. Therefore, before storing data, users need to create at least one bucket.
Operation types
You can create a bucket through the console, SDK, and API, as follows:
- To create a bucket through the console, please refer to [Create Bucket](BOS/Console Operation Guide/Managing Bucket/Create bucket.md).
-
To create a bucket through the SDK:
- [Java SDK](BOS/SDK/Java-SDK/Bucket management/Create Bucket.md)
- [Python SDK](BOS/SDK/Python-SDK/Bucket management/Create Bucket.md)
- [PHP SDK](BOS/SDK/PHP-SDK/Bucket management.md#Create Bucket)
- [C# SDK](BOS/SDK/C-Dotnet-SDK/Bucket management.md#Create Bucket)
- [JavaScript SDK](BOS/SDK/JavaScript-SDK/Bucket management.md#Create Bucket)
- [Android SDK](BOS/SDK/Android-SDK/Bucket management/Create Bucket.md)
- [iOS SDK](BOS/SDK/IOS-SDK/Bucket management/Create New Bucket.md)
- [Ruby SDK](BOS/SDK/Ruby-SDK/Bucket management/Create Bucket.md)
- [GO SDK](BOS/SDK/GO-SDK/Bucket management.md#Create Bucket)
- [C++ SDK](BOS/SDK/C++-SDK/Bucket management/Create Bucket.md)
-
To create a bucket through the API:
Note
- Each user can create a maximum of 100 buckets.
- 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.
- 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 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 [Update Bucket Permissions](BOS/Console Operation Guide/Managing Bucket/Set bucket read-write permissions/Set bucket read-write permissions.md).
- CDN acceleration is enabled by default when a bucket is created. If you wish to disable it, you can simply set the "CDN Official Acceleration" option to OFF during the creation process.
- 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 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](BOS/Product Description/Tiered Storage Introduction/Why Tiered Storage Exists.md).
