.TH "GCLOUD_ALPHA_STORAGE_BUCKETS_CREATE" 1



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



.SH "SYNOPSIS"
.HP
\f5gcloud alpha 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"

\fB(ALPHA)\fR 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 alpha storage buckets create gs://my\-bucket \e
    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 alpha 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 command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation\-only early access
allowlist. This variant is also available:

.RS 2m
$ gcloud storage buckets create
.RE