Definition
A bucket is the carrier of objects, which can be understood as the container for storing objects. Users can manage the bucket and configure its attributes through various methods such as the cloud console, API, and SDK. For example, users can configure the bucket for static website hosting, configure bucket access permissions, and more.
Naming Specifications
The bucket name consists of two parts: a user-defined string and a system generated numeric string (APPID), connected by a hyphen “-”. For example, in examplebucket-1250000000, examplebucket is a user-defined string and 1250000000 is a system-generated numeric string (APPID). In the examples of API and SDK, the bucket naming format is <BucketName-APPID>.
- System generated numeric string APPID: This is automatically assigned by the system, and no user input is required. It is unique in Converge Cloud.
- A user-defined string of characters: A string of characters manually input by the user. The specifications are as follows.
A custom string of characters in the following naming conventions:- Only lowercase English letters and numbers are allowed, namely a to z, 0 to 9, hyphens -, and their combinations.
- The user-defined string of characters can be 1 to 50 characters.
- A bucket name cannot start or end with -.
The following are examples of valid bucket names:
- mybucket123-1250000000
- 1-newproject-1250000000
Access Permission
A bucket provides two types of permissions by default: public and user.
Public Permissions
Public permissions include: Private Read/Write, Public Read/Private Write, and Public Read/Write. You can modify the access permissions in Permission Management of the bucket in the COS console.
- Private Read/Write
Only the creator of the bucket and authorized accounts have Read/Write permission on the objects in the bucket. The default access permission of a bucket is Private Read/Write, which is recommended. - Public read/private write
Anyone (including anonymous visitors) has Read permission on the objects in the bucket, but only the bucket creator and authorized accounts have Write permission on them. - Public read/write
Anyone (including anonymous visitors) has Read/Write permission on the objects in the bucket, which is not recommended.
User Permissions
A root account has all the permissions (full control) for buckets by default. In COS, you can also add sub-accounts that are granted permissions to read/write data and permissions, and even full control, which is the highest permission level.
Related Description
- Object storage stores objects using a flat structure instead of folders.
- Each user account can create multiple buckets, with a number of up to 200 (in all regions), but there is no limit on the number of objects in a bucket.
- The bucket name under one APPID must be unique.
- Once a bucket is created, it cannot be renamed. To rename a bucket, you need to delete it and create another one with the desired name.
- When creating a bucket, make sure to select the desired region, as the region cannot be changed once specified.