gcloud: Thu Nov 9 11:45:52 UTC 2023

gcloud/alpha/sql/instances/create

@@ -12,9 +12,9 @@ SYNOPSIS
         [--authorized-networks=NETWORK,[NETWORK,...]]
         [--availability-type=AVAILABILITY_TYPE] [--no-backup]
         [--backup-location=BACKUP_LOCATION]
-        [--backup-start-time=BACKUP_START_TIME] [--collation=COLLATION]
-        [--connector-enforcement=CONNECTOR_ENFORCEMENT] [--cpu=CPU]
-        [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]]
+        [--backup-start-time=BACKUP_START_TIME] [--cascadable-replica]
+        [--collation=COLLATION] [--connector-enforcement=CONNECTOR_ENFORCEMENT]
+        [--cpu=CPU] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]]
         [--database-version=DATABASE_VERSION; default="MYSQL_8_0"]
         [--[no-]deletion-protection]
         [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE]
@@ -169,6 +169,13 @@ FLAGS
         Start time of daily backups, specified in the HH:MM format, in the UTC
         timezone.
 
+     --cascadable-replica
+        Specifies whether a SQL Server replica is a cascadable replica. A
+        cascadable replica is a SQL Server cross-region replica that supports
+        replica(s) under it. This flag only takes effect when the
+        --master-instance-name flag is set, and the replica under creation is
+        in a different region than the primary instance.
+
      --collation=COLLATION
         Cloud SQL server-level collation setting, which specifies the set of
         rules for comparing characters in a character set.

gcloud/alpha/sql/instances/help

@@ -71,6 +71,9 @@ COMMANDS
      restore-backup
         (ALPHA) Restores a backup of a Cloud SQL instance.
 
+     switchover
+        (ALPHA) Switches over a Cloud SQL instance to one of its replicas.
+
 NOTES
     This command is currently in alpha and might change without notice. If this
     command fails with API permission errors despite specifying the correct

gcloud/alpha/sql/instances/promote-replica

@@ -4,7 +4,7 @@ NAME
 
 SYNOPSIS
     gcloud alpha sql instances promote-replica REPLICA [--async]
-        [GCLOUD_WIDE_FLAG ...]
+        [--[no-]failover] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     (ALPHA) Promotes Cloud SQL read replica to a stand-alone instance.
@@ -18,6 +18,10 @@ FLAGS
         Return immediately, without waiting for the operation in progress to
         complete.
 
+     --[no-]failover
+        Whether the promote operation is a failover. Use --failover to enable
+        and --no-failover to disable.
+
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,
     --billing-project, --configuration, --flags-file, --flatten, --format,

gcloud/alpha/sql/instances/switchover

@@ -0,0 +1,42 @@
+NAME
+    gcloud alpha sql instances switchover - switches over a Cloud SQL instance
+        to one of its replicas
+
+SYNOPSIS
+    gcloud alpha sql instances switchover REPLICA [--async]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (ALPHA) 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 alpha 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.
+
+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
+    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. This variant is also available:
+
+        $ gcloud beta sql instances switchover
+