.TH "GCLOUD_RESOURCE\-MANAGER_FOLDERS_CREATE" 1



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



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

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 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 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"

These variants are also available:

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

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