.TH "GCLOUD_ALPHA_SQL_USERS_SET\-PASSWORD" 1



.SH "NAME"
.HP
gcloud alpha sql users set\-password \- changes a user's password in a given instance



.SH "SYNOPSIS"
.HP
\f5gcloud alpha sql users set\-password\fR \fIUSERNAME\fR \fB\-\-instance\fR=\fIINSTANCE\fR, \fB\-i\fR \fIINSTANCE\fR [\fB\-\-async\fR] [\fB\-\-host\fR=\fIHOST\fR] [\fB\-\-discard\-dual\-password\fR\ |\ \fB\-\-retain\-password\fR] [\fB\-\-password\fR=\fIPASSWORD\fR\ |\ \fB\-\-prompt\-for\-password\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Changes a user's password in a given instance with specified
username and host.



.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

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-discard\-dual\-password\fR

Discard the user's secondary password. Cannot set password and set this flag.
This flag is only available for MySQL 8.0.

.TP 2m
\fB\-\-retain\-password\fR

Retain the old password when changing to the new password. Must set password
with this flag. This flag is only available for MySQL 8.0.

.RE
.sp
.TP 2m

At most one of these can be specified:


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

Cloud SQL user's password.

.TP 2m
\fB\-\-prompt\-for\-password\fR

Prompt for the Cloud SQL user's password with character echo disabled. The
password is all typed characters up to but not including the RETURN or ENTER
key.


.RE
.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 sql users set\-password
.RE

.RS 2m
$ gcloud beta sql users set\-password
.RE