gcloud: Wed Mar 19 10:42:21 UTC 2025

gcloud/sql/instances/create

@@ -42,10 +42,14 @@ SYNOPSIS
         [--psc-auto-connections=[network=NETWORK],[project=PROJECT]]
         [--[no-]recreate-replicas-on-primary-crash]
         [--replica-type=REPLICA_TYPE] [--replication=REPLICATION]
-        [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT]
+        [--require-ssl] [--[no-]retain-backups-on-delete]
+        [--retained-backups-count=RETAINED_BACKUPS_COUNT]
         [--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS]
         [--root-password=ROOT_PASSWORD] [--server-ca-mode=SERVER_CA_MODE]
-        [--ssl-mode=SSL_MODE] [--[no-]storage-auto-increase]
+        [--server-ca-pool=SERVER_CA_POOL] [--ssl-mode=SSL_MODE]
+        [--[no-]storage-auto-increase]
+        [--storage-provisioned-iops=STORAGE_PROVISIONED_IOPS]
+        [--storage-provisioned-throughput=STORAGE_PROVISIONED_THROUGHPUT]
         [--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE]
         [--tags=TAG=VALUE,[TAG=VALUE,...]]
         [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER]
@@ -63,28 +67,28 @@ DESCRIPTION
     Creates a new Cloud SQL instance.
 
 EXAMPLES
-    To create a MySQL 5.7 instance with ID prod-instance that has 2 CPUs, 4 GB
+    To create a MySQL 8.0 instance with ID prod-instance that has 2 CPUs, 4 GB
     of RAM, and is in the region us-central1 (a zone will be auto-assigned),
     where the 'root' user has its password set to password123, run:
 
         $ gcloud sql instances create prod-instance \
-            --database-version=MYSQL_5_7 --cpu=2 --memory=4GB \
+            --database-version=MYSQL_8_0 --cpu=2 --memory=4GB \
             --region=us-central1 --root-password=password123
 
-    To create a Postgres 9.6 instance with ID prod-instance that has 2 CPUs, 8
+    To create a Postgres 15 instance with ID prod-instance that has 2 CPUs, 8
     GiB of RAM, and is in the zone us-central1-a, where the 'postgres' user has
     its password set to password123, run:
 
         $ gcloud sql instances create prod-instance \
-            --database-version=POSTGRES_9_6 --cpu=2 --memory=8GiB \
+            --database-version=POSTGRES_15 --cpu=2 --memory=8GiB \
             --zone=us-central1-a --root-password=password123
 
-    To create a SQL Server 2017 Express instance with ID prod-instance that has
+    To create a SQL Server 2022 Express instance with ID prod-instance that has
     2 CPUs, 3840MiB of RAM, and is in the zone us-central1-a, where the
     'sqlserver' user has its password set to password123, run:
 
         $ gcloud sql instances create prod-instance \
-            --database-version=SQLSERVER_2017_EXPRESS --cpu=2 \
+            --database-version=SQLSERVER_2022_EXPRESS --cpu=2 \
             --memory=3840MiB --zone=us-central1-a \
             --root-password=password123
 
@@ -415,6 +419,11 @@ FLAGS
      --require-ssl
         Specified if users connecting over IP must use SSL.
 
+     --[no-]retain-backups-on-delete
+        Retain automated/ondemand backups of the instance after the instance is
+        deleted. Use --retain-backups-on-delete to enable and
+        --no-retain-backups-on-delete to disable.
+
      --retained-backups-count=RETAINED_BACKUPS_COUNT
         How many backups to keep. The valid range is between 1 and 365. Default
         value is 7 for Enterprise edition instances. For Enterprise_Plus,
@@ -443,6 +452,9 @@ FLAGS
          GOOGLE_MANAGED_INTERNAL_CA
             Google-managed self-signed internal CA.
 
+     --server-ca-pool=SERVER_CA_POOL
+        Set the server CA pool of the instance.
+
      --ssl-mode=SSL_MODE
         Set the SSL mode of the instance. SSL_MODE must be one of:
 
@@ -465,6 +477,14 @@ FLAGS
         --storage-auto-increase to enable and --no-storage-auto-increase to
         disable.
 
+     --storage-provisioned-iops=STORAGE_PROVISIONED_IOPS
+        Indicates how many IOPS to provision for the data disk. This sets the
+        number of I/O operations per second that the disk can handle.
+
+     --storage-provisioned-throughput=STORAGE_PROVISIONED_THROUGHPUT
+        Indicates how much throughput to provision for the data disk. This sets
+        the throughput in MB per second that the disk can handle.
+
      --storage-size=STORAGE_SIZE
         Amount of storage allocated to the instance. Must be an integer number
         of GB. The default is 10GB. Information on storage limits can be found