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

gcloud/sql/backups/restore

@@ -33,6 +33,8 @@ SYNOPSIS
         [--retained-backups-count=RETAINED_BACKUPS_COUNT]
         [--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS]
         [--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]
         [--tier=TIER, -t TIER] [--time-zone=TIME_ZONE]
         [--timeout=TIMEOUT; default=3600]
@@ -308,6 +310,14 @@ OPTIONAL 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

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

gcloud/sql/instances/patch

@@ -41,8 +41,11 @@ SYNOPSIS
         [--pricing-plan=PRICING_PLAN, -p PRICING_PLAN]
         [--[no-]recreate-replicas-on-primary-crash]
         [--remove-deny-maintenance-period] [--replication=REPLICATION]
-        [--[no-]require-ssl] [--simulate-maintenance-event]
-        [--ssl-mode=SSL_MODE] [--[no-]storage-auto-increase]
+        [--[no-]require-ssl] [--[no-]retain-backups-on-delete]
+        [--simulate-maintenance-event] [--ssl-mode=SSL_MODE]
+        [--[no-]storage-auto-increase]
+        [--storage-provisioned-iops=STORAGE_PROVISIONED_IOPS]
+        [--storage-provisioned-throughput=STORAGE_PROVISIONED_THROUGHPUT]
         [--storage-size=STORAGE_SIZE]
         [--switch-transaction-logs-to-cloud-storage]
         [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER]
@@ -366,6 +369,11 @@ FLAGS
         mysqld should default to 'REQUIRE X509' for users connecting over IP.
         Use --require-ssl to enable and --no-require-ssl to disable.
 
+     --[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.
+
      --simulate-maintenance-event
         Simulate a maintenance event without changing the version. Only
         applicable to instances that support near-zero downtime planned
@@ -393,6 +401,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