gcloud: Wed Dec 11 10:18:23 UTC 2024

gcloud/sql/instances/create

@@ -44,11 +44,11 @@ SYNOPSIS
         [--replica-type=REPLICA_TYPE] [--replication=REPLICATION]
         [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT]
         [--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS]
-        [--root-password=ROOT_PASSWORD] [--ssl-mode=SSL_MODE]
-        [--[no-]storage-auto-increase] [--storage-size=STORAGE_SIZE]
-        [--storage-type=STORAGE_TYPE] [--threads-per-core=THREADS_PER_CORE]
-        [--tier=TIER, -t TIER] [--time-zone=TIME_ZONE]
-        [--timeout=TIMEOUT; default=3600]
+        [--root-password=ROOT_PASSWORD] [--server-ca-mode=SERVER_CA_MODE]
+        [--ssl-mode=SSL_MODE] [--[no-]storage-auto-increase]
+        [--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE]
+        [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER]
+        [--time-zone=TIME_ZONE] [--timeout=TIMEOUT; default=3600]
         [--allowed-psc-projects=PROJECT,[PROJECT,...]
           --enable-private-service-connect]
         [--disk-encryption-key=DISK_ENCRYPTION_KEY
@@ -430,6 +430,18 @@ FLAGS
      --root-password=ROOT_PASSWORD
         Root Cloud SQL user's password.
 
+     --server-ca-mode=SERVER_CA_MODE
+        Set the server CA mode of the instance. SERVER_CA_MODE must be one of:
+
+         CUSTOMER_MANAGED_CAS_CA
+            Customer-managed CA hosted on Google Cloud's Certificate Authority
+            Service (CAS).
+         GOOGLE_MANAGED_CAS_CA
+            Google-managed regional CA part of root CA hierarchy hosted on
+            Google Cloud's Certificate Authority Service (CAS).
+         GOOGLE_MANAGED_INTERNAL_CA
+            Google-managed self-signed internal CA.
+
      --ssl-mode=SSL_MODE
         Set the SSL mode of the instance. SSL_MODE must be one of:
 

gcloud/sql/ssl/help

@@ -24,6 +24,10 @@ GROUPS
      server-ca-certs
         Provide commands for managing server CA certs of Cloud SQL instances.
 
+     server-certs
+        Provide commands for managing server certificates of Cloud SQL
+        instances.
+
 NOTES
     These variants are also available:
 

gcloud/sql/ssl/server-certs/create

@@ -0,0 +1,35 @@
+NAME
+    gcloud sql ssl server-certs create - create a server certificate for a
+        Cloud SQL instance
+
+SYNOPSIS
+    gcloud sql ssl server-certs create --instance=INSTANCE, -i INSTANCE
+        [--async] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Create a server certificate for a Cloud SQL instance.
+
+REQUIRED FLAGS
+     --instance=INSTANCE, -i INSTANCE
+        Cloud SQL instance ID.
+
+OPTIONAL FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+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
+    These variants are also available:
+
+        $ gcloud alpha sql ssl server-certs create
+
+        $ gcloud beta sql ssl server-certs create
+

gcloud/sql/ssl/server-certs/help

@@ -0,0 +1,38 @@
+NAME
+    gcloud sql ssl server-certs - provide commands for managing server
+        certificates of Cloud SQL instances
+
+SYNOPSIS
+    gcloud sql ssl server-certs COMMAND [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Provide commands for managing server certificates of Cloud SQL instances,
+    including creating, listing, rotating in, and rolling back certificates.
+
+GCLOUD WIDE FLAGS
+    These flags are available to all commands: --help.
+
+    Run $ gcloud help for details.
+
+COMMANDS
+    COMMAND is one of the following:
+
+     create
+        Create a server certificate for a Cloud SQL instance.
+
+     list
+        List all server certificates for a Cloud SQL instance.
+
+     rollback
+        Roll back to the previous server certificate for a Cloud SQL instance.
+
+     rotate
+        Rotate in the upcoming server certificate for a Cloud SQL instance.
+
+NOTES
+    These variants are also available:
+
+        $ gcloud alpha sql ssl server-certs
+
+        $ gcloud beta sql ssl server-certs
+

gcloud/sql/ssl/server-certs/list

@@ -0,0 +1,63 @@
+NAME
+    gcloud sql ssl server-certs list - list all server certificates for a Cloud
+        SQL instance
+
+SYNOPSIS
+    gcloud sql ssl server-certs list --instance=INSTANCE, -i INSTANCE
+        [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
+        [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    List all server certificates for a Cloud SQL instance.
+
+REQUIRED FLAGS
+     --instance=INSTANCE, -i INSTANCE
+        Cloud SQL instance ID.
+
+LIST COMMAND FLAGS
+     --filter=EXPRESSION
+        Apply a Boolean filter EXPRESSION to each resource item to be listed.
+        If the expression evaluates True, then that item is listed. For more
+        details and examples of filter expressions, run $ gcloud topic filters.
+        This flag interacts with other flags that are applied in this order:
+        --flatten, --sort-by, --filter, --limit.
+
+     --limit=LIMIT
+        Maximum number of resources to list. The default is unlimited. This
+        flag interacts with other flags that are applied in this order:
+        --flatten, --sort-by, --filter, --limit.
+
+     --page-size=PAGE_SIZE
+        Some services group resource list output into pages. This flag
+        specifies the maximum number of resources per page. The default is
+        determined by the service if it supports paging, otherwise it is
+        unlimited (no paging). Paging may be applied before or after --filter
+        and --limit depending on the service.
+
+     --sort-by=[FIELD,...]
+        Comma-separated list of resource field key names to sort by. The
+        default order is ascending. Prefix a field with ``~'' for descending
+        order on that field. This flag interacts with other flags that are
+        applied in this order: --flatten, --sort-by, --filter, --limit.
+
+     --uri
+        Print a list of resource URIs instead of the default output, and change
+        the command output to a list of URIs. If this flag is used with
+        --format, the formatting is applied on this URI list. To display URIs
+        alongside other keys instead, use the uri() transform.
+
+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
+    These variants are also available:
+
+        $ gcloud alpha sql ssl server-certs list
+
+        $ gcloud beta sql ssl server-certs list
+

gcloud/sql/ssl/server-certs/rollback

@@ -0,0 +1,35 @@
+NAME
+    gcloud sql ssl server-certs rollback - roll back to the previous server
+        certificate for a Cloud SQL instance
+
+SYNOPSIS
+    gcloud sql ssl server-certs rollback --instance=INSTANCE, -i INSTANCE
+        [--async] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Roll back to the previous server certificate for a Cloud SQL instance.
+
+REQUIRED FLAGS
+     --instance=INSTANCE, -i INSTANCE
+        Cloud SQL instance ID.
+
+OPTIONAL FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+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
+    These variants are also available:
+
+        $ gcloud alpha sql ssl server-certs rollback
+
+        $ gcloud beta sql ssl server-certs rollback
+

gcloud/sql/ssl/server-certs/rotate

@@ -0,0 +1,35 @@
+NAME
+    gcloud sql ssl server-certs rotate - rotate in the upcoming server
+        certificate for a Cloud SQL instance
+
+SYNOPSIS
+    gcloud sql ssl server-certs rotate --instance=INSTANCE, -i INSTANCE
+        [--async] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Rotate in the upcoming server certificate for a Cloud SQL instance.
+
+REQUIRED FLAGS
+     --instance=INSTANCE, -i INSTANCE
+        Cloud SQL instance ID.
+
+OPTIONAL FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+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
+    These variants are also available:
+
+        $ gcloud alpha sql ssl server-certs rotate
+
+        $ gcloud beta sql ssl server-certs rotate
+