.TH "GCLOUD_ALPHA_RESOURCE\-MANAGER_FOLDERS_CREATE" 1



.SH "NAME"
.HP
gcloud alpha resource\-manager folders create \- create a new folder



.SH "SYNOPSIS"
.HP
\f5gcloud alpha resource\-manager folders create\fR \fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR [\fB\-\-async\fR] [\fB\-\-folder\fR=\fIFOLDER_ID\fR] [\fB\-\-organization\fR=\fIORGANIZATION_ID\fR] [\fB\-\-tags\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Creates a new folder in the given parent folder or organization.



.SH "EXAMPLES"

The following command creates a folder with the name \f5abc\fR into a folder
with the ID \f52345\fR:

.RS 2m
$ gcloud alpha resource\-manager folders create \-\-display\-name=abc \e
    \-\-folder=2345
.RE

The following command creates a folder with the name \f5abc\fR into an
organization with ID \f51234\fR:

.RS 2m
$ gcloud alpha resource\-manager folders create \-\-display\-name=abc \e
    \-\-organization=1234
.RE



.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR

Friendly display name to use for the new folder.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.

.TP 2m
\fB\-\-folder\fR=\fIFOLDER_ID\fR

ID for the folder to use as a parent

.TP 2m
\fB\-\-organization\fR=\fIORGANIZATION_ID\fR

ID for the organization to use as a parent

.TP 2m
\fB\-\-tags\fR=[\fIKEY\fR=\fIVALUE\fR,...]

List of tags KEY=VALUE pairs to bind. Each item must be expressed as
\f5<tag\-key\-namespaced\-name>=<tag\-value\-short\-name>\fR.

Example: \f5123/environment=production,123/costCenter=marketing\fR

Note: Currently this field is in Preview.


.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. These variants are also available:

.RS 2m
$ gcloud resource\-manager folders create
.RE

.RS 2m
$ gcloud beta resource\-manager folders create
.RE