.TH "GCLOUD_STORAGE_BUCKETS_CREATE" 1



.SH "NAME"
.HP
gcloud storage buckets create \- create buckets for storing objects



.SH "SYNOPSIS"
.HP
\f5gcloud storage buckets create\fR \fIURL\fR [\fIURL\fR\ ...] [\fB\-\-additional\-headers\fR=\fIHEADER\fR=\fIVALUE\fR] [\fB\-\-default\-encryption\-key\fR=\fIDEFAULT_ENCRYPTION_KEY\fR,\ \fB\-k\fR\ \fIDEFAULT_ENCRYPTION_KEY\fR] [\fB\-\-default\-storage\-class\fR=\fIDEFAULT_STORAGE_CLASS\fR,\ \fB\-c\fR\ \fIDEFAULT_STORAGE_CLASS\fR,\ \fB\-s\fR\ \fIDEFAULT_STORAGE_CLASS\fR] [\fB\-\-enable\-hierarchical\-namespace\fR] [\fB\-\-enable\-per\-object\-retention\fR] [\fB\-\-ip\-filter\-file\fR=\fIIP_FILTER_FILE\fR] [\fB\-\-lifecycle\-file\fR=\fILIFECYCLE_FILE\fR] [\fB\-\-location\fR=\fILOCATION\fR,\ \fB\-l\fR\ \fILOCATION\fR] [\fB\-\-[no\-]pap\fR,\ \fB\-\-[no\-]public\-access\-prevention\fR] [\fB\-\-placement\fR=[\fIREGION\fR,...]] [\fB\-\-recovery\-point\-objective\fR=\fISETTING\fR,\ \fB\-\-rpo\fR=\fISETTING\fR] [\fB\-\-retention\-period\fR=\fIRETENTION_PERIOD\fR] [\fB\-\-soft\-delete\-duration\fR=\fISOFT_DELETE_DURATION\fR] [\fB\-\-[no\-]uniform\-bucket\-level\-access\fR,\ \fB\-b\fR] [\fB\-\-autoclass\-terminal\-storage\-class\fR=\fIAUTOCLASS_TERMINAL_STORAGE_CLASS\fR\ \fB\-\-[no\-]enable\-autoclass\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create new buckets.



.SH "EXAMPLES"

The following command creates 2 Cloud Storage buckets, one named
\f5\fImy\-bucket\fR\fR and a second bucket named \f5\fImy\-other\-bucket\fR\fR:

.RS 2m
$ gcloud storage buckets create gs://my\-bucket gs://my\-other\-bucket
.RE

The following command creates a bucket with the \f5\fInearline\fR\fR default
storage class (https://cloud.google.com/storage/docs/storage\-classes) in the
\f5\fIasia\fR\fR location (https://cloud.google.com/storage/docs/locations):

.RS 2m
$ gcloud storage buckets create gs://my\-bucket \e
    \-\-default\-storage\-class=nearline \-\-location=asia
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIURL\fR [\fIURL\fR ...]

The URLs of the buckets to create.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-additional\-headers\fR=\fIHEADER\fR=\fIVALUE\fR

Includes arbitrary headers in storage API calls. Accepts a comma separated list
of key=value pairs, e.g. \f5header1=value1,header2=value2\fR. Overrides the
default \fBstorage/additional_headers\fR property value for this command
invocation.

.TP 2m
\fB\-\-default\-encryption\-key\fR=\fIDEFAULT_ENCRYPTION_KEY\fR, \fB\-k\fR \fIDEFAULT_ENCRYPTION_KEY\fR

Set the default KMS key using the full path to the key, which has the following
form:
\f5\fIprojects/[project\-id]/locations/[location]/keyRings/[key\-ring]/cryptoKeys/[my\-key]\fR\fR.

.TP 2m
\fB\-\-default\-storage\-class\fR=\fIDEFAULT_STORAGE_CLASS\fR, \fB\-c\fR \fIDEFAULT_STORAGE_CLASS\fR, \fB\-s\fR \fIDEFAULT_STORAGE_CLASS\fR

Default storage class (https://cloud.google.com/storage/docs/storage\-classes)
for the bucket. If not specified, the default storage class used by Cloud
Storage is "Standard".

.TP 2m
\fB\-\-enable\-hierarchical\-namespace\fR

Enable hierarchical namespace for the bucket. To use this flag, you must also
use \-\-uniform\-bucket\-level\-access

.TP 2m
\fB\-\-enable\-per\-object\-retention\fR

Enables each object in the bucket to have its own retention settings, which
prevents deletion until stored for a specific length of time.

.TP 2m
\fB\-\-ip\-filter\-file\fR=\fIIP_FILTER_FILE\fR

Sets the IP filter for the bucket. The IP filter is a list of ip ranges that are
allowed to access the bucket. For example, The following JSON document shows the
IP filter configuration with mode enabled and list of public network sources and
vpc network sources:

.RS 2m
{
  "mode": "Enabled",
  "publicNetworkSource": { "allowedIpCidrRanges": ["0.0.0.0/0"] },
  "vpcNetworkSources": [
      {
          "network": "projects/PROJECT_NAME/global/networks/NETWORK_NAME",
          "allowedIpCidrRanges": ["0.0.0.0/0"]
      },
  ]
}
.RE

For more information about supported configurations, see Cloud Storage bucket IP
filtering configurations
(https://cloud.google.com/storage/docs/create\-ip\-filter#ip\-filtering\-configurations)

.TP 2m
\fB\-\-lifecycle\-file\fR=\fILIFECYCLE_FILE\fR

Sets the lifecycle management configuration on a bucket. For example, The
following lifecycle management configuration JSON document specifies that all
objects in this bucket that are more than 365 days old are deleted
automatically:

.RS 2m
{
  "rule":
  [
    {
      "action": {"type": "Delete"},
      "condition": {"age": 365}
    }
  ]
}
.RE

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR, \fB\-l\fR \fILOCATION\fR

Location (https://cloud.google.com/storage/docs/locations) for the bucket. If
not specified, the location used by Cloud Storage is \f5\fIus\fR\fR. A bucket's
location cannot be changed after creation.

.TP 2m
\fB\-\-[no\-]pap\fR, \fB\-\-[no\-]public\-access\-prevention\fR

Sets public access prevention to "enforced". For details on how exactly public
access is blocked, see:
http://cloud.google.com/storage/docs/public\-access\-prevention. Use
\fB\-\-public\-access\-prevention\fR to enable and
\fB\-\-no\-public\-access\-prevention\fR to disable.

.TP 2m
\fB\-\-placement\fR=[\fIREGION\fR,...]

A comma\-separated list of regions that form the custom dual\-region
(https://cloud.google.com/storage/docs/locations#location\-dr). Only regions
within the same continent are or will ever be valid. Invalid location pairs
(such as mixed\-continent, or with unsupported regions) will return an error.

.TP 2m
\fB\-\-recovery\-point\-objective\fR=\fISETTING\fR, \fB\-\-rpo\fR=\fISETTING\fR

Sets the recovery point objective
(https://cloud.google.com/architecture/dr\-scenarios\-planning\-guide#basics_of_dr_planning)
of a bucket. This flag can only be used with multi\-region and dual\-region
buckets. \f5DEFAULT\fR option is valid for multi\-region and dual\-regions
buckets. \f5ASYNC_TURBO\fR option is only valid for dual\-region buckets. If
unspecified when the bucket is created, it defaults to \f5DEFAULT\fR for
dual\-region and multi\-region buckets. For more information, see replication in
Cloud Storage
(https://cloud.google.com/storage/docs/availability\-durability#cross\-region\-redundancy).
\fISETTING\fR must be one of: \fBASYNC_TURBO\fR, \fBDEFAULT\fR.

.TP 2m
\fB\-\-retention\-period\fR=\fIRETENTION_PERIOD\fR

Minimum retention period
(https://cloud.google.com/storage/docs/bucket\-lock#retention\-periods) for
objects stored in the bucket, for example
\f5\fI\-\-retention\-period=P1Y1M1DT5S\fR\fR. Objects added to the bucket cannot
be deleted until they've been stored for the specified length of time. Default
is no retention period. Only available for Cloud Storage using the JSON API.

.TP 2m
\fB\-\-soft\-delete\-duration\fR=\fISOFT_DELETE_DURATION\fR

Duration to retain soft\-deleted objects. For example, "2w1d" is two weeks and
one day. See \f5gcloud topic datetimes\fR for more information on the duration
format. Setting \f50\fR will disable soft delete policy on the bucket. Default
is 7 days.

.TP 2m
\fB\-\-[no\-]uniform\-bucket\-level\-access\fR, \fB\-b\fR

Turns on uniform bucket\-level access setting. Default is False. Use
\fB\-\-uniform\-bucket\-level\-access\fR to enable and
\fB\-\-no\-uniform\-bucket\-level\-access\fR to disable.


.RE
.sp

.SH "AUTOCLASS FLAGS"

.RS 2m
.TP 2m
\fB\-\-autoclass\-terminal\-storage\-class\fR=\fIAUTOCLASS_TERMINAL_STORAGE_CLASS\fR

The storage class that objects in the bucket eventually transition to if they
are not read for a certain length of time. Only valid if Autoclass is enabled.

.TP 2m
\fB\-\-[no\-]enable\-autoclass\fR

The Autoclass feature automatically selects the best storage class for objects
based on access patterns. Use \fB\-\-enable\-autoclass\fR to enable and
\fB\-\-no\-enable\-autoclass\fR to disable.


.RE
.sp

.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-access\-token\-file, \-\-account,
\-\-billing\-project, \-\-configuration, \-\-flags\-file, \-\-flatten,
\-\-format, \-\-help, \-\-impersonate\-service\-account, \-\-log\-http,
\-\-project, \-\-quiet, \-\-trace\-token, \-\-user\-output\-enabled,
\-\-verbosity.

Run \fB$ gcloud help\fR for details.



.SH "NOTES"

This variant is also available:

.RS 2m
$ gcloud alpha storage buckets create
.RE