.TH "GCLOUD_BETA_SQL_USERS_CREATE" 1



.SH "NAME"
.HP
gcloud beta sql users create \- creates a user in a given instance



.SH "SYNOPSIS"
.HP
\f5gcloud beta sql users create\fR \fIUSERNAME\fR \fB\-\-instance\fR=\fIINSTANCE\fR, \fB\-i\fR \fIINSTANCE\fR [\fB\-\-async\fR] [\fB\-\-host\fR=\fIHOST\fR] [\fB\-\-password\fR=\fIPASSWORD\fR] [\fB\-\-password\-policy\-allowed\-failed\-attempts\fR=\fIPASSWORD_POLICY_ALLOWED_FAILED_ATTEMPTS\fR] [\fB\-\-[no\-]password\-policy\-enable\-failed\-attempts\-check\fR] [\fB\-\-[no\-]password\-policy\-enable\-password\-verification\fR] [\fB\-\-password\-policy\-password\-expiration\-duration\fR=\fIPASSWORD_POLICY_PASSWORD_EXPIRATION_DURATION\fR] [\fB\-\-type\fR=\fITYPE\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR Creates a user in a given instance with specified username, host,
type, and password.



.SH "POSITIONAL ARGUMENTS"

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

Cloud SQL username.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-instance\fR=\fIINSTANCE\fR, \fB\-i\fR \fIINSTANCE\fR

Cloud SQL instance ID.


.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\-\-host\fR=\fIHOST\fR

Cloud SQL user's hostname expressed as a specific IP address or address range.
\f5%\fR denotes an unrestricted hostname. Applicable flag for MySQL instances;
ignored for all other engines. Note, if you connect to your instance using IP
addresses, you must add your client IP address as an authorized address, even if
your hostname is unrestricted. For more information, see Configure IP
(https://cloud.google.com/sql/docs/mysql/configure\-ip).

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

Cloud SQL user's password.

.TP 2m
\fB\-\-password\-policy\-allowed\-failed\-attempts\fR=\fIPASSWORD_POLICY_ALLOWED_FAILED_ATTEMPTS\fR

Number of failed login attempts allowed before a user is locked out.

.TP 2m
\fB\-\-[no\-]password\-policy\-enable\-failed\-attempts\-check\fR

Enables the failed login attempts check if set to true. Use
\fB\-\-password\-policy\-enable\-failed\-attempts\-check\fR to enable and
\fB\-\-no\-password\-policy\-enable\-failed\-attempts\-check\fR to disable.

.TP 2m
\fB\-\-[no\-]password\-policy\-enable\-password\-verification\fR

The current password must be specified when altering the password. Use
\fB\-\-password\-policy\-enable\-password\-verification\fR to enable and
\fB\-\-no\-password\-policy\-enable\-password\-verification\fR to disable.

.TP 2m
\fB\-\-password\-policy\-password\-expiration\-duration\fR=\fIPASSWORD_POLICY_PASSWORD_EXPIRATION_DURATION\fR

Expiration duration after a password is updated, for example, 2d for 2 days. See
\f5gcloud topic datetimes\fR for information on duration formats.

.TP 2m
\fB\-\-type\fR=\fITYPE\fR

Cloud SQL user's type. It determines the method to authenticate the user during
login. See the list of user types at
https://cloud.google.com/sql/docs/postgres/admin\-api/rest/v1beta4/SqlUserType


.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 beta and might change without notice. These
variants are also available:

.RS 2m
$ gcloud sql users create
.RE

.RS 2m
$ gcloud alpha sql users create
.RE