gcloud: Wed Aug 7 09:49:06 UTC 2024

gcloud/sql/instances/help

@@ -69,6 +69,9 @@ COMMANDS
      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/sql/instances/switchover

@@ -0,0 +1,46 @@
+NAME
+    gcloud sql instances switchover - switches over a Cloud SQL instance to one
+        of its replicas
+
+SYNOPSIS
+    gcloud sql instances switchover REPLICA [--async] [--db-timeout=DB_TIMEOUT]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Switches over a Cloud SQL instance to one of its replicas. Only supported
+    on Cloud SQL for SQL Server and MySQL instances.
+
+EXAMPLES
+    To switch over an instance to its replica called replica-instance:
+
+        $ gcloud sql instances switchover replica-instance
+
+POSITIONAL ARGUMENTS
+     REPLICA
+        Cloud SQL replica ID.
+
+FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+     --db-timeout=DB_TIMEOUT
+        (MySQL only) Cloud SQL instance operations timeout, which is the sum of
+        all database operations. Default value is 10 minutes and can be
+        modified to a maximum value of 24h.
+
+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 $ gcloud help for details.
+
+NOTES
+    These variants are also available:
+
+        $ gcloud alpha sql instances switchover
+
+        $ gcloud beta sql instances switchover
+