.TH "GCLOUD_ALPHA_SQL_USERS_DESCRIBE" 1



.SH "NAME"
.HP
gcloud alpha sql users describe \- retrieves information about a Cloud SQL user in a given instance



.SH "SYNOPSIS"
.HP
\f5gcloud alpha sql users describe\fR \fIUSERNAME\fR \fB\-\-instance\fR=\fIINSTANCE\fR, \fB\-i\fR \fIINSTANCE\fR [\fB\-\-host\fR=\fIHOST\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Retrieves information about a Cloud SQL user in a given instance.



.SH "EXAMPLES"

To fetch a user with name 'my\-user' and optional host '%' in instance
\'my\-instance', run:

.RS 2m
$ gcloud alpha sql users describe my\-user \-\-host=% \e
    \-\-instance=my\-instance
.RE



.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\-\-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).


.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 describe
.RE

.RS 2m
$ gcloud beta sql users describe
.RE