Create a bucket

This page shows you how to create a Cloud Storagebucket. If nototherwise specified in your request, buckets are created in theUS multi-region with a default storage class ofStandard storageand have a seven-daysoft delete retention duration.

Note: A bucket's name is non-editable metadata.If you need to designate a specific name, it must bespecified at bucket creation.

Required roles

Note: The following content describes the required IAM roles andpermissions for creating a bucket with basic settings. If you want to set up cross-bucket replication as part of creating your bucket, you needadditional roles and permissions. Refer toBefore you begin in thecross-bucket replication user guide for information on the roles and permissionsrequired.

In order to get the required permissions for creating a Cloud Storagebucket, ask your administrator to grant you the Storage Admin(roles/storage.admin) IAM role for the project.

Thispredefined role contains the permission required to create a bucket.To see the exact permissions that are required, expand theRequired permissions section:

Required permissions

storage.buckets.create
storage.buckets.enableObjectRetention (only required ifenablingobject retention configurationsfor the bucket)
storage.buckets.list (only required if creating abucket using the Google Cloud console.)
resourcemanager.projects.get (only required if creating abucket using the Google Cloud console)

You might also be able to get these permissions withcustom roles or otherpredefined roles. To see which roles are associated with which permissions,refer toIAM roles for Cloud Storage.

For instructions on granting roles for projects, seeManage access to projects.

Create a new bucket

If you are creating a bucket for the first time, seeDiscover object storagewith the Google Cloud console orDiscover object storage with theGoogle Cloud CLI tool.

To create a bucket with specific settings or advanced configurations, completethe following steps:

Console

When creating a bucket using the Google Cloud console, you are onlyrequired to set a globally unique name for your bucket; all other steps areeither optional or have default settings.

In the Google Cloud console, go to the Cloud StorageBuckets page.
Go to Buckets
ClickCreate.
On theCreate a bucket page, enter your bucket information. After each of the following steps, clickContinue to proceed to the next step:
1. In theGet started section, do the following:
  - Enter a globally unique name that meets thebucket name requirements.
  - To add abucket label, click the expander arrow to expand theLabels section, clickAdd label, and specify akey and avalue for your label.
2. In theChoose where to store your data section, do the following:
  1. Select aLocation type.
  2. Use the location type's drop-down menu to select aLocation where object data within your bucket will be permanently stored.
    - If you select thedual-region location type, you can also choose to enableturbo replication by using the relevant checkbox.
  3. To set upcross-bucket replication, selectAdd cross-bucket replication via Storage Transfer Service and follow the steps:
    Set up cross-bucket replication
    In theBucket menu, select a bucket.
    In theReplication settings section, clickConfigure to configure settings for the replication job.
    TheConfigure cross-bucket replication pane appears.
    To filter objects to replicate by object name prefix, enter a prefix with which you want to include or exclude objects, then clickAdd a prefix.
    To set a storage class for the replicated objects, select a storage class from theStorage class menu. If you skip this step, the replicated objects will use the destination bucket's storage class by default.
    ClickDone.
3. In theChoose how to store your data section, do the following:
  1. Select adefault storage class for the bucket orAutoclass for automatic storage class management of your bucket's data.
  2. In theOptimize storage for data-intensive workloads section, do the following:
    1. To enablehierarchical namespace, selectEnable Hierarchical namespace on this bucket.
      Note: You cannot enable hierarchical namespace in an existing bucket.
    2. To enableAnywhere Cache, selectEnable Anywhere Cache and follow the steps:
      1. To create caches, clickConfigure.
      2. In theConfigure cache settings dialog that appears, click the drop-down arrow next to the listed regions and select the zones where you want to create caches.
      3. ClickDone.
4. In theChoose how to control access to objects section, select whether or not your bucket enforcespublic access prevention, and select anaccess control model for your bucket's objects.
  Note: If public access prevention is already enforced by your project's organization policy, thePrevent public access checkbox is locked.
5. In theChoose how to protect object data section, do the following:
  - Select any of the options underData protection that you want to set for your bucket.
  - To enablesoft delete, click expander arrow labeledsoft delete policy, and specify the number of days you want to retain objects after deletion.
  - To choose how your object data will be encrypted, click the expander arrow labeledData encryption, and select aData encryption method.
ClickCreate.

To learn how to get detailed error information about failed Cloud Storage operations in the Google Cloud console, seeTroubleshooting.

Command line

Note: Cloud Shell provisions a temporary virtual machine. If youwant to upload objects to Cloud Storage or download objects fromCloud Storage, use a local development environment.

In the Google Cloud console, activate Cloud Shell.
Activate Cloud Shell
At the bottom of the Google Cloud console, aCloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
In your development environment, run thegcloud storage buckets create command:
```
gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION
```
Where:
- BUCKET_NAME is the name you want to give yourbucket, subject tonaming requirements. For example,my-bucket.
- BUCKET_LOCATION is thelocation of yourbucket. For example,US.
  Note: When creating a configurable dual-region, you mustset the--location flag to be thelocation code associated withthe underlying regions, and you must use the--placement flag with a valid pair of regions. For example,--location=ASIA --placement=ASIA-EAST1,ASIA-SOUTHEAST1.
If the request is successful, the command returns the following message:
```
Creating gs://BUCKET_NAME/...
```
Set the following flags to have greater control over the creation ofyour bucket:
- --project: Specify the project ID or project number with which yourbucket will be associated. For example,my-project.
- --default-storage-class: Specify the defaultstorage classof your bucket. For example,STANDARD.
- --uniform-bucket-level-access: Enableuniform bucket-level accessfor your bucket.
- --soft-delete-duration: Specify asoft delete retentionduration, which is the number of days you want to retain objects afterthey get deleted. For example,10d.
For example:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access--soft-delete-duration=RETENTION_DURATION
```
For a complete list of options for bucket creation using thegcloud CLI, seebuckets create options.