Hide
Google Cloud Storage

mb - Make buckets

mb - Make buckets

Synopsis

gsutil mb [-c class] [-l location] [-p proj_id] uri...

Description

The mb command creates a new bucket. Google Cloud Storage has a single namespace, so you will not be allowed to create a bucket with a name already in use by another user. You can, however, carve out parts of the bucket name space corresponding to your company’s domain name (see “gsutil help naming”).

If you don’t specify a project ID using the -p option, the bucket will be created using the default project ID specified in your gsutil configuration file (see gsutil help config). For more details about projects see gsutil help projects.

The -c and -l options specify the storage class and location, respectively, for the bucket. Once a bucket is created in a given location and with a given storage class, it cannot be moved to a different location, and the storage class cannot be changed. Instead, you would need to create a new bucket and move the data over and then delete the original bucket.

Bucket Storage Classes

If you don’t specify a -c option, the bucket will be created with the default (Standard) storage class.

If you specify -c DURABLE_REDUCED_AVAILABILITY (or -c DRA), it causes the data stored in the bucket to use Durable Reduced Availability storage. Buckets created with this storage class have lower availability than Standard storage class buckets, but durability equal to that of buckets created with Standard storage class. This option allows users to reduce costs for data for which lower availability is acceptable. Durable Reduced Availability storage would not be appropriate for “hot” objects (i.e., objects being accessed frequently) or for interactive workloads; however, it might be appropriate for other types of applications. See the online documentation for pricing and SLA details.

If you specify -c NEARLINE (or -c NL), it causes the data stored in the bucket to use Nearline storage. Buckets created with this storage class have higher latency and lower throughput than Standard storage class buckets. The availability and durability remains equal to that of buckets created with the Standard storage class. This option is best for objects which are accessed rarely and for which slower performance is acceptable. See the online documentation for pricing and SLA details.

Bucket Locations

If you don’t specify a -l option, the bucket will be created in the default location (US). Otherwise, you can specify one of the available continental locations:

  • ASIA (Asia)
  • EU (European Union)
  • US (United States)
Example:
gsutil mb -l ASIA gs://some-bucket

If you specify the Durable Reduced Availability storage class (-c DRA), you can specify one of the continental locations above or one of the regional locations below:

  • ASIA-EAST1 (Eastern Asia-Pacific)
  • US-EAST1 (Eastern United States) [1]
  • US-EAST2 (Eastern United States) [1]
  • US-EAST3 (Eastern United States) [1]
  • US-CENTRAL1 (Central United States) [1]
  • US-CENTRAL2 (Central United States) [1]
  • US-WEST1 (Western United States) [1]
Example:
gsutil mb -c DRA -l US-CENTRAL1 gs://some-bucket
[1](1, 2, 3, 4, 5, 6) These locations are for Regional Buckets. Regional Buckets is an experimental feature and data stored in these locations is not subject to the usual SLA. See the documentation for additional information.

Options

-c class Can be DRA (or DURABLE_REDUCED_AVAILABILITY), NL (or NEARLINE, or S (or STANDARD). Default is STANDARD.
-l location Can be any continental location as described above, or for DRA storage class, any regional or continental location. Default is US. Locations are case insensitive.
-p proj_id Specifies the project ID under which to create the bucket.