Updated on 2024-04-16 GMT+08:00

Creating a Bucket

A bucket is a container that stores objects in OBS. Before you store data in OBS, you need to create a bucket.

An account can create a maximum of 100 buckets and parallel file systems.

Procedure

  1. In the upper right corner of the OBS Console homepage, click Create Bucket.
  2. Configure bucket parameters.

    Table 1 Bucket parameters

    Parameter

    Description

    Region

    Geographic area where a bucket resides. For low latency and faster access, select the region nearest to you. Once the bucket is created, its region cannot be changed.

    AZ

    Isolated physical location where a bucket resides. If a region has multiple AZs, you can create buckets in clusters in different AZs and implement cross-AZ disaster recovery using cross-cluster replication. For details, see Cross-Cluster Replication.

    Cluster Group

    Cluster where a bucket resides. OBS provides cross-cluster replication to implement cross-AZ disaster recovery. For details, see Cross-Cluster Replication.

    Bucket Name

    Name of the bucket. A bucket name must be unique across all accounts and regions. Once a bucket is created, its name cannot be changed.

    According to the globally applied DNS naming rules, an OBS bucket name:

    • Must be unique across all accounts and regions. The name of a deleted bucket can be reused for another bucket or a parallel file system at least 30 minutes after the deletion.
    • Must be 3 to 63 characters long. Only lowercase letters, digits, hyphens (-), and periods (.) are allowed.
    • 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.
    • Cannot be formatted as an IP address.
      NOTE:

      When you access OBS through HTTPS using virtual hosted-style URLs, if the bucket name contains a period (.), the certificate verification will fail. To work around this issue, you are advised not to use periods (.) in bucket names.

    Cluster Type

    • Public cluster: If you select this option, the bucket you are creating will be in a public cluster shared with others.
    • Dedicated cluster: If you select this option, the bucket you are creating will be in the dedicated cluster you purchased.
      NOTE:

      The cluster type feature is only available to users who have purchased dedicated clusters. For the other users, the bucket they create is in a public cluster by default.

    Disaster Recovery

    • Disable: Data is stored only in one single AZ at a lower cost.
    • Enable: Data is redundantly stored in two AZs in the same region. This delivers a higher reliability but costs more. Once enabled, the two-AZ disaster recovery cannot be disabled.

    Data Redundancy Policy

    • Multi-AZ storage: Data is stored in multiple AZs to achieve higher reliability.
    • Single-AZ storage: Data is stored in a single AZ, with lower costs.

    Once a bucket is created, the data redundancy policy cannot be changed, so choose the policy that can meet your needs.

    Bucket Policy

    Controls read and write permissions for buckets.

    • Private: No access beyond the bucket ACL settings is granted.
    • Public Read: Anyone can read objects in the bucket.
    • Public Read and Write: Anyone can read, write, or delete objects in the bucket.

  3. Click Create Now.