HEX
Server: Apache/2.4.65 (Ubuntu)
System: Linux ielts-store-v2 6.8.0-1036-gcp #38~22.04.1-Ubuntu SMP Thu Aug 14 01:19:18 UTC 2025 x86_64
User: root (0)
PHP: 7.2.34-54+ubuntu20.04.1+deb.sury.org+1
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,
Upload Files
File: //snap/google-cloud-cli/396/help/man/man1/gcloud_sql_instances.1
.TH "GCLOUD_SQL_INSTANCES" 1



.SH "NAME"
.HP
gcloud sql instances \- provide commands for managing Cloud SQL instances



.SH "SYNOPSIS"
.HP
\f5gcloud sql instances\fR \fICOMMAND\fR [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Provide commands for managing Cloud SQL instances including creating,
configuring, restarting, and deleting instances.



.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-help.

Run \fB$ gcloud help\fR for details.



.SH "COMMANDS"

\f5\fICOMMAND\fR\fR is one of the following:

.RS 2m
.TP 2m
\fBacquire\-ssrs\-lease\fR

Acquires a SQL Server Reporting Services lease on a Cloud SQL instance.

.TP 2m
\fBclone\fR

Clones a Cloud SQL instance.

.TP 2m
\fBcreate\fR

Creates a new Cloud SQL instance.

.TP 2m
\fBdelete\fR

Deletes a Cloud SQL instance.

.TP 2m
\fBdescribe\fR

Displays configuration and metadata about a Cloud SQL instance.

.TP 2m
\fBexport\fR

\fB(DEPRECATED)\fR Exports data from a Cloud SQL instance.

.TP 2m
\fBfailover\fR

Causes a high\-availability Cloud SQL instance to failover.

.TP 2m
\fBget\-latest\-recovery\-time\fR

Displays the latest recovery time to which a Cloud SQL instance can be restored
to.

.TP 2m
\fBimport\fR

\fB(DEPRECATED)\fR Imports data into a Cloud SQL instance from Google Cloud
Storage.

.TP 2m
\fBlist\fR

Lists Cloud SQL instances in a given project.

.TP 2m
\fBpatch\fR

Updates the settings of a Cloud SQL instance.

.TP 2m
\fBpre\-check\-major\-version\-upgrade\fR

Performs pre\-checks for a major version upgrade of a Cloud SQL instance.

.TP 2m
\fBpromote\-replica\fR

Promotes Cloud SQL read replica to a stand\-alone instance.

.TP 2m
\fBreencrypt\fR

Reencrypts a Cloud SQL CMEK instance.

.TP 2m
\fBrelease\-ssrs\-lease\fR

Releases a SQL Server Reporting Services lease on a Cloud SQL instance.

.TP 2m
\fBreset\-ssl\-config\fR

Reset SSL materials according to the reset SSL mode.

.TP 2m
\fBrestart\fR

Restarts a Cloud SQL instance.

.TP 2m
\fBrestore\-backup\fR

Restores a backup of a Cloud SQL instance.

.TP 2m
\fBswitchover\fR

Switches over a Cloud SQL instance to one of its replicas.


.RE
.sp

.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha sql instances
.RE

.RS 2m
$ gcloud beta sql instances
.RE