.TH "GCLOUD_ALLOYDB_USERS_CREATE" 1



.SH "NAME"
.HP
gcloud alloydb users create \- creates a user in a given cluster



.SH "SYNOPSIS"
.HP
\f5gcloud alloydb users create\fR \fIUSERNAME\fR \fB\-\-cluster\fR=\fICLUSTER\fR \fB\-\-region\fR=\fIREGION\fR [\fB\-\-db\-roles\fR=[\fIROLE\fR,...]] [\fB\-\-keep\-extra\-roles\fR=\fIKEEP_EXTRA_ROLES\fR] [\fB\-\-password\fR=\fIPASSWORD\fR] [\fB\-\-superuser\fR=\fISUPERUSER\fR] [\fB\-\-type\fR=\fITYPE\fR;\ default=\f5"BUILT_IN"\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Creates a user in a given cluster with specified username, cluster, region,
type, and password.



.SH "EXAMPLES"

To create a new user, run:

.RS 2m
$ gcloud alloydb users create my\-username \-\-cluster=my\-cluster \e
    \-\-region=us\-central1 \-\-password=postgres
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIUSERNAME\fR

AlloyDB username


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-cluster\fR=\fICLUSTER\fR

AlloyDB cluster ID

.TP 2m
\fB\-\-region\fR=\fIREGION\fR

Regional location (e.g. \f5asia\-east1\fR, \f5us\-east1\fR). See the full list
of regions at https://cloud.google.com/sql/docs/instance\-locations.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-db\-roles\fR=[\fIROLE\fR,...]

Comma separated list of database roles this new user will be granted upon
creation.

.TP 2m
\fB\-\-keep\-extra\-roles\fR=\fIKEEP_EXTRA_ROLES\fR

If the user already exists and has extra roles, keep them.

.TP 2m
\fB\-\-password\fR=\fIPASSWORD\fR

Password for this database user.

.TP 2m
\fB\-\-superuser\fR=\fISUPERUSER\fR

If true, new user will have AlloyDB superuser privileges. Default value is
false.

.TP 2m
\fB\-\-type\fR=\fITYPE\fR; default=\f5"BUILT_IN"\fR

Type corresponds to the user type. \fITYPE\fR must be one of:

.RS 2m
.TP 2m
\fBBUILT_IN\fR
This database user can authenticate via password\-based authentication
.TP 2m
\fBIAM_BASED\fR
This database user can authenticate via IAM\-based authentication
.RE
.sp



.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 alloydb users create
.RE

.RS 2m
$ gcloud beta alloydb users create
.RE