- NAME
-
- gcloud sql instances - provide commands for managing Cloud SQL instances
- SYNOPSIS
-
-
gcloud sql instancesCOMMAND[GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
- Provide commands for managing Cloud SQL instances including creating, configuring, restarting, and deleting instances.
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--help.Run
$ gcloud helpfor details. - COMMANDS
-
is one of the following:COMMAND-
acquire-ssrs-lease - Acquires a SQL Server Reporting Services lease on a Cloud SQL instance.
-
clone - Clones a Cloud SQL instance.
-
create - Creates a new Cloud SQL instance.
-
delete - Deletes a Cloud SQL instance.
-
describe - Displays configuration and metadata about a Cloud SQL instance.
-
execute-sql - Executes a statement on a Cloud SQL instance.
-
export -
(DEPRECATED)Exports data from a Cloud SQL instance. -
failover - Causes a high-availability Cloud SQL instance to failover.
-
get-latest-recovery-time - Displays the latest recovery time to which a Cloud SQL instance can be restored to.
-
get-storage-shrink-config - Displays the minimum storage size to which a Cloud SQL instance can be decreased.
-
import -
(DEPRECATED)Imports data into a Cloud SQL instance from Google Cloud Storage. -
list - Lists Cloud SQL instances in a given project.
-
patch - Updates the settings of a Cloud SQL instance.
-
perform-storage-shrink - Performs a storage size decrease of a Cloud SQL instance.
-
point-in-time-restore - Performs a point in time restore for a Cloud SQL instance managed by Google Cloud Backup and Disaster Recovery (DR) Service.
-
pre-check-major-version-upgrade - Performs pre-checks for a major version upgrade of a Cloud SQL instance.
-
promote-replica - Promotes Cloud SQL read replica to a stand-alone instance.
-
reencrypt - Reencrypts a Cloud SQL CMEK instance.
-
release-ssrs-lease - Releases a SQL Server Reporting Services lease on a Cloud SQL instance.
-
reset-ssl-config - Reset SSL materials according to the reset SSL mode.
-
restart - Restarts a Cloud SQL instance.
-
restore-backup - Restores a backup of a Cloud SQL instance.
-
switchover - Switches over a Cloud SQL instance to one of its replicas.
-
- NOTES
- These variants are also available:
gcloud alpha sql instancesgcloud beta sql instances
gcloud sql instances
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

