gcloud: Wed Oct 11 10:37:28 UTC 2023

gcloud/firestore/databases/create

@@ -4,7 +4,7 @@ NAME
 
 SYNOPSIS
     gcloud firestore databases create --location=LOCATION
-        [--database=DATABASE; default="(default)"]
+        [--database=DATABASE; default="(default)"] [--enable-pitr]
         [--type=TYPE; default="firestore-native"] [GCLOUD_WIDE_FLAG ...]
 
 EXAMPLES
@@ -22,6 +22,11 @@ EXAMPLES
         $ gcloud firestore databases create --database=foo \
           --location=us-east1 --type=datastore-mode
 
+    To create a Firestore Native database in nam5 with Point In Time Recovery
+    (PITR) enabled.
+
+        $ gcloud firestore databases create --location=nam5 --enable-pitr
+
 REQUIRED FLAGS
      --location=LOCATION
         The location to operate on. Available locations are listed at
@@ -43,6 +48,13 @@ OPTIONAL FLAGS
 
             Using "(default)" database ID is also allowed.
 
+     --enable-pitr
+        Whether to enable Point In Time Recovery (PITR) on the created
+        database.
+
+            If set to true, PITR on the new database will be enabled. By default,
+            this feature is not enabled.
+
      --type=TYPE; default="firestore-native"
         The type of the database. TYPE must be one of: firestore-native,
         datastore-mode.

gcloud/firestore/databases/update

@@ -4,7 +4,7 @@ NAME
 
 SYNOPSIS
     gcloud firestore databases update [--async] [--database=DATABASE]
-        [--type=TYPE] [GCLOUD_WIDE_FLAG ...]
+        [--enable-pitr] [--type=TYPE] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     Update the database configuration of a Cloud Firestore database.
@@ -39,6 +39,11 @@ FLAGS
           ▸ provide the argument --database on the command line;
           ▸ the default value of argument [--database] is (default).
 
+     --enable-pitr
+        If set to true, the Firestore database will be updated to enable Point
+        In Time Recovery. You can disable the this feature via
+        --no-enable-pitr.
+
      --type=TYPE
         The database type. TYPE must be one of: datastore-mode,
         firestore-native.

gcloud/firestore/export

@@ -6,7 +6,8 @@ SYNOPSIS
     gcloud firestore export OUTPUT_URI_PREFIX [--async]
         [--collection-ids=[COLLECTION_IDS,...]]
         [--database=DATABASE; default="(default)"]
-        [--namespace-ids=[NAMESPACE_IDS,...]] [GCLOUD_WIDE_FLAG ...]
+        [--namespace-ids=[NAMESPACE_IDS,...]] [--snapshot-time=SNAPSHOT_TIME]
+        [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     export Cloud Firestore documents to Google Cloud Storage.
@@ -28,6 +29,11 @@ EXAMPLES
         $ gcloud firestore export gs://mybucket/my/path \
             --namespace-ids='specific namespace id'
 
+    To export from a snapshot at '2023-05-26T10:20:00.00Z', run:
+
+        $ gcloud firestore export gs://mybucket/my/path \
+            --snapshot-time='2023-05-26T10:20:00.00Z'
+
 POSITIONAL ARGUMENTS
      OUTPUT_URI_PREFIX
         Location where the export files will be stored. Must be a valid Google
@@ -70,6 +76,22 @@ FLAGS
 
             $ gcloud firestore export --namespaces-ids='customers','orders'
 
+     --snapshot-time=SNAPSHOT_TIME
+        The version of the database to export.
+
+        The timestamp must be rounded to the minute, in the past, and not older
+        than 5 days. Please choose a reasonable timestamp based on prior
+        knowledge on how long exports take as data at provided snapshot
+        timestamp can expire during export.
+
+        If specified, then the exported documents will represent a consistent
+        view of the database at the provided time. Otherwise, there are no
+        guarantees about the consistency of the exported documents.
+
+        For example, to operate on snapshot time 2023-05-26T10:20:00.00Z:
+
+            $ gcloud firestore export --snapshot-time='2023-05-26T10:20:00.00Z'
+
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,
     --billing-project, --configuration, --flags-file, --flatten, --format,