gcloud: Wed Oct 26 10:52:11 UTC 2022

gcloud/alpha/firestore/databases/create

@@ -3,18 +3,43 @@ NAME
         Native database via Firestore API
 
 SYNOPSIS
-    gcloud alpha firestore databases create [--location=LOCATION]
+    gcloud alpha firestore databases create [DATABASE] --location=LOCATION
         [--type=TYPE; default="firestore-native"] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    (ALPHA) Create a Google Cloud Firestore Native database via Firestore API.
+    (ALPHA) 'EXAMPLES': To create Cloud Firestore Native database in nam5.
 
-FLAGS
+        $ gcloud alpha firestore databases create --location=nam5
+
+    To create Cloud Datastore Mode database in us-east1.
+
+        $ gcloud alpha firestore databases create --location=us-east1 \
+          --type=datastore-mode
+
+    To create Cloud Datastore Mode database in us-east1 with a databaseId foo.
+
+        $ gcloud alpha firestore databases create foo --location=us-east1 \
+          --type=datastore-mode
+
+POSITIONAL ARGUMENTS
+     [DATABASE]
+        The ID to use for the database, which will become the final component
+        of the database's resource name. If database ID is not provided,
+        (default) will be used as database ID.
+
+            This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/
+            with first character a letter and the last a letter or a number. Must
+            not be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.
+
+            Using "(default)" database ID is also allowed.
+
+REQUIRED FLAGS
      --location=LOCATION
         The location to create the Google Cloud Firestore Native database
-        within. Available databases are listed at
+        within. Available locations are listed at
         https://cloud.google.com/firestore/docs/locations.
 
+OPTIONAL FLAGS
      --type=TYPE; default="firestore-native"
         The type of the database. TYPE must be one of: firestore-native,
         datastore-mode.