gcloud: Thu Sep 7 10:42:28 UTC 2023

gcloud/alpha/firestore/databases/help

@@ -28,6 +28,9 @@ COMMANDS
      list
         (ALPHA) Lists all Firestore databases under the project.
 
+     restore
+        (ALPHA) Restores a Cloud Firestore database from a backup.
+
      update
         (ALPHA) Update the database configuration of a Cloud Firestore
         database.

gcloud/alpha/firestore/databases/restore

@@ -0,0 +1,50 @@
+NAME
+    gcloud alpha firestore databases restore - restores a Cloud Firestore
+        database from a backup
+
+SYNOPSIS
+    gcloud alpha firestore databases restore
+        --destination-database=DESTINATION_DATABASE
+        --source-backup=SOURCE_BACKUP [GCLOUD_WIDE_FLAG ...]
+
+EXAMPLES
+    To restore a database from a backup.
+
+        $ gcloud alpha firestore databases restore \
+          --source-backup=projects/PROJECT_ID/locations/LOCATION_ID/\
+        backups/BACKUP_ID --destination-database=DATABASE_ID
+
+REQUIRED FLAGS
+     --destination-database=DESTINATION_DATABASE
+        Destination database to restore to. Destination database will be
+        created in the same location as the source backup.
+
+        For example, to restore to database testdb:
+
+            $ gcloud alpha firestore databases restore \
+                --destination-database=testdb
+
+     --source-backup=SOURCE_BACKUP
+        The source backup to restore from.
+
+        For example, to restore from backup
+        cf9f748a-7980-4703-b1a1-d1ffff591db0 in us-east1:
+
+            $ gcloud alpha firestore databases restore \
+                --source-backup=projects/PROJECT_ID/locations/us-east1/backups/\
+            cf9f748a-7980-4703-b1a1-d1ffff591db0
+
+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.
+