gcloud: Thu Jul 4 09:30:26 UTC 2024

gcloud/alloydb/backups/create

@@ -18,17 +18,27 @@ EXAMPLES
         $ gcloud alloydb backups create my-backup --cluster=my-cluster \
             --region=us-central1
 
+    To create a new cross-region backup, run:
+
+        $ gcloud alloydb backups create \
+            projects/my-project/locations/us-west1/backups/my-backup \
+            --cluster=my-cluster --region=us-central1
+
 POSITIONAL ARGUMENTS
      BACKUP
-        AlloyDB backup ID
+        The AlloyDB backup to create. This must either be the backup ID
+        (myBackup) or the full backup path
+        (projects/myProject/locations/us-central1/backups/myBackup). In the
+        first case, the project and location are assumed to be the same as the
+        cluster being backed up. The second form can be used to create
+        cross-region and cross-project backups.
 
 REQUIRED FLAGS
      --cluster=CLUSTER
         AlloyDB cluster ID
 
      --region=REGION
-        The region of the cluster to backup. Note: both the cluster and the
-        backup have to be in the same region.
+        The region of the cluster to backup.
 
 OPTIONAL FLAGS
      --async

gcloud/alloydb/clusters/help

@@ -38,6 +38,9 @@ COMMANDS
         Restore an AlloyDB cluster from a given backup or a source cluster and
         a timestamp.
 
+     switchover
+        Switchover an AlloyDB SECONDARY cluster in a given project and region.
+
      update
         Update an AlloyDB cluster within a given project and region.
 

gcloud/alloydb/clusters/switchover

@@ -0,0 +1,45 @@
+NAME
+    gcloud alloydb clusters switchover - switchover an AlloyDB SECONDARY
+        cluster in a given project and region
+
+SYNOPSIS
+    gcloud alloydb clusters switchover CLUSTER --region=REGION [--async]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Switchover an AlloyDB SECONDARY cluster in a given project and region.
+
+EXAMPLES
+    To switchover a cluster, run:
+
+        $ gcloud alloydb clusters switchover my-cluster --region=us-central1
+
+POSITIONAL ARGUMENTS
+     CLUSTER
+        AlloyDB cluster ID
+
+REQUIRED FLAGS
+     --region=REGION
+        Regional location (e.g. asia-east1, us-east1). See the full list of
+        regions at https://cloud.google.com/sql/docs/instance-locations.
+
+OPTIONAL 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
+    These variants are also available:
+
+        $ gcloud alpha alloydb clusters switchover
+
+        $ gcloud beta alloydb clusters switchover
+