.TH "GCLOUD_BETA_PROJECTS_CREATE" 1



.SH "NAME"
.HP
gcloud beta projects create \- create a new project



.SH "SYNOPSIS"
.HP
\f5gcloud beta projects create\fR [\fIPROJECT_ID\fR] [\fB\-\-no\-enable\-cloud\-apis\fR] [\fB\-\-folder\fR=\fIFOLDER_ID\fR] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-name\fR=\fINAME\fR] [\fB\-\-organization\fR=\fIORGANIZATION_ID\fR] [\fB\-\-set\-as\-default\fR] [\fB\-\-tags\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR Creates a new project with the given project ID. By default,
projects are not created under a parent resource. To do so, use either the
\f5\-\-organization\fR or \f5\-\-folder\fR flag.



.SH "EXAMPLES"

The following command creates a project with ID \f5example\-foo\-bar\-1\fR, name
\f5Happy project\fR and label \f5type=happy\fR:

.RS 2m
$ gcloud beta projects create example\-foo\-bar\-1 \e
    \-\-name="Happy project" \-\-labels=type=happy
.RE

By default, projects are not created under a parent resource. The following
command creates a project with ID \f5example\-2\fR with parent
\f5folders/12345\fR:

.RS 2m
$ gcloud beta projects create example\-2 \-\-folder=12345
.RE

The following command creates a project with ID \f5example\-3\fR with parent
\f5organizations/2048\fR:

.RS 2m
$ gcloud beta projects create example\-3 \-\-organization=2048
.RE



.SH "POSITIONAL ARGUMENTS"

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

ID for the project you want to create.

Project IDs are immutable and can be set only during project creation. They must
start with a lowercase letter and can have lowercase ASCII letters, digits or
hyphens. Project IDs must be between 6 and 30 characters.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-enable\-cloud\-apis\fR

Enable \f5cloudapis.googleapis.com\fR during creation. Enabled by default, use
\fB\-\-no\-enable\-cloud\-apis\fR to disable.

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

ID for the folder to use as a parent

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

List of label KEY=VALUE pairs to add.

Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers. Values must contain
only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase characters, and
numbers.

.TP 2m
\fB\-\-name\fR=\fINAME\fR

Name for the project you want to create. If not specified, will use project id
as name.

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

ID for the organization to use as a parent

.TP 2m
\fB\-\-set\-as\-default\fR

Set newly created project as [core/project] property.

.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 "SEE ALSO"

See https://support.google.com/cloud/answer/6251787 for information on creating
or deleting projects from the Google Cloud Platform Console.



.SH "NOTES"

This command is currently in beta and might change without notice. These
variants are also available:

.RS 2m
$ gcloud projects create
.RE

.RS 2m
$ gcloud alpha projects create
.RE