• Object Storage Service

  1. Help Center
  2. Object Storage Service
  3. User Guide
  4. OBS Browser Operation Guide
  5. Managing Buckets
  6. Adding a Bucket

Adding a Bucket

On OBS, buckets are containers where objects are stored. Before you store data in OBS, you need to create buckets.


An account can create 100 buckets.


  1. Log in to OBS Browser.
  2. In the upper left corner on the page, click Add Bucket.
  3. In the Add Bucket dialog box, displayed in Figure 1, enter the bucket information as required.

    Figure 1 Adding a bucket
    Table 1 Parameters of adding a bucket




    Select Create new bucket.


    Region where the bucket to be created is located.

    Storage Class

    OBS has the following storage classes: Standard, Warm, and Cold. In such a manner, OBS comprehensively meets customers' requirements on storage performance and costs.

    • Standard: features low access latency and high throughput.
    • Warm: applicable to storing semi-frequently accessed (less than 12 times a year) data requiring quick response.
    • Cold: applicable to archiving rarely-accessed (once a year) data.

    Bucket Name

    Name the bucket according to the globally applied DNS naming regulation as follows:

    • The name must be globally unique in OBS.
    • The name must contain 3 to 63 characters. Only lowercase letters, digits, hyphens (-), and periods (.) are allowed.
    • The name cannot start or end with a period (.) or hyphen (-), and cannot contain two consecutive periods (.) or contain a period (.) and a hyphen (-) adjacent to each other.
    • The name cannot be an IP address.
    • If the name contains any period (.), the security certificate verification may be triggered when you access the bucket or objects in the bucket.

    You can move the pointer over  behind the Bucket Name text box to view the naming rules for a bucket.

    • When a URL is used to access a bucket, the bucket name will become a part of the URL. According to the DNS rule, URLs do not support uppercase letters and cannot be used to access a bucket whose name contains uppercase letters. Therefore, a bucket name can contain only lowercase letters, digits, hyphens (-), and periods (.) For example, if you attempt to access bucket MyBucket using the URL, bucket mybucket will be accessed instead, causing an access error.
    • DNS naming can standardize the bucket naming globally, facilitating the resolution when accessing a bucket. Users can benefit from new functions and optimized features, and static website hosting is then applicable to buckets.

  4. Click OK.
  5. In the dialog box that is displayed, click OK.

Region Information Configuration

The Region information can be configured on OBS Browser. The following details the configuration procedure:

  1. Open file region in folder OBS Browser in the decompression path of OBS Browser.
  2. Change the value of parameter options in file region.

    Enter the region information to be added to the end of parameter options in the following format:

    {"key":"Region alias","value":"Region"}

    The newly added information must be in the JSON format. The following describes the parameters.

    • key: indicates a user-defined region alias. Its value is in the Region drop-down list in the Add Bucket dialog box. For a convenient view, you are advised to enter not more than 25 characters.
    • value: indicates Region. Enter its value based on Region supported by OBS.

      Each time when a Region is added, a group of values will be added to options, that is, {"key":"Region alias","value":"Region"}. Groups of values are separated by commas (,). The following provides two configuration examples of newly added region01 and region02. Keep the values of other parameters in file region unchanged.


  3. After file region is successfully modified, restart OBS Browser so that the configurations can take effect.

Follow-up Procedure

You can specify its storage class when creating a bucket or change its storage class after bucket creation.

  1. Log in to OBS Browser.
  2. In the bucket list, select the target bucket and click  on the right.
  3. Select the desired storage class and click OK.

    Changing the storage class of a bucket does not change the storage class of any object in the bucket.

  4. In the dialog box that is displayed, click OK.