gcloud: Wed Jun 19 09:33:28 UTC 2024

gcloud/alpha/alloydb/clusters/create

@@ -59,7 +59,7 @@ OPTIONAL FLAGS
 
      --database-version=DATABASE_VERSION
         Database version of the cluster. DATABASE_VERSION must be one of:
-        POSTGRES_14, POSTGRES_15.
+        POSTGRES_14, POSTGRES_15, POSTGRES_16.
 
      --enable-private-service-connect
         Enable Private Service Connect (PSC) connectivity for the cluster.

gcloud/alpha/alloydb/clusters/help

@@ -40,6 +40,10 @@ COMMANDS
         (ALPHA) Restore an AlloyDB cluster from a given backup or a source
         cluster and a timestamp.
 
+     switchover
+        (ALPHA) Switchover an AlloyDB SECONDARY cluster in a given project and
+        region.
+
      update
         (ALPHA) Update an AlloyDB cluster within a given project and region.
 

gcloud/alpha/alloydb/clusters/switchover

@@ -0,0 +1,46 @@
+NAME
+    gcloud alpha alloydb clusters switchover - switchover an AlloyDB SECONDARY
+        cluster in a given project and region
+
+SYNOPSIS
+    gcloud alpha alloydb clusters switchover CLUSTER --region=REGION [--async]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (ALPHA) Switchover an AlloyDB SECONDARY cluster in a given project and
+    region.
+
+EXAMPLES
+    To switchover a cluster, run:
+
+        $ gcloud alpha alloydb clusters switchover my-cluster \
+            --region=us-central1
+
+POSITIONAL ARGUMENTS
+     CLUSTER
+        AlloyDB cluster ID
+
+REQUIRED FLAGS
+     --region=REGION
+        Regional location (e.g. asia-east1, us-east1). See the full list of
+        regions at https://cloud.google.com/sql/docs/instance-locations.
+
+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
+    This command is currently in alpha and might change without notice. If this
+    command fails with API permission errors despite specifying the correct
+    project, you might be trying to access an API with an invitation-only early
+    access allowlist.
+

gcloud/alpha/alloydb/instances/create

@@ -7,6 +7,7 @@ SYNOPSIS
         --cpu-count=CPU_COUNT --instance-type=INSTANCE_TYPE --region=REGION
         [--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]]
         [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async]
+        [--authorized-external-networks=[AUTHORIZED_NETWORK,...]]
         [--availability-type=AVAILABILITY_TYPE]
         [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]]
         [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE]
@@ -71,19 +72,25 @@ OPTIONAL FLAGS
         --allowed-psc-projects=project1,12345678,project2)
 
      --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP
-        Specify to enable or disable public IP on an instance. On instance
-        creation only disabling public IP is allowed. If you want to enable
-        public IP, an instance must be created with public IP disabled first,
-        then update the instance to enable public IP. ASSIGN_INBOUND_PUBLIC_IP
-        must be (only one value is supported):
-
-         NO_PUBLIC_IP
-            This disables public IP on the instance.
+        Specify to enable or disable public IP on an instance.
+        ASSIGN_INBOUND_PUBLIC_IP must be one of:
+        ◆ NO_PUBLIC_IP
+          ▸ This disables public IP on the instance. Updating an instance to
+            disable public IP will clear the list of authorized networks.
+        ◆ ASSIGN_IPV4
+          ▸ Assign an inbound public IPv4 address for the instance. Public IP
+            is enabled.
 
      --async
         Return immediately, without waiting for the operation in progress to
         complete.
 
+     --authorized-external-networks=[AUTHORIZED_NETWORK,...]
+        Comma-separated list of authorized external networks to set on the
+        instance. Authorized networks should use CIDR notation (e.g.
+        1.2.3.4/30). This flag is only allowed to be set for instances with
+        public IP enabled.
+
      --availability-type=AVAILABILITY_TYPE
         Specifies level of availability. AVAILABILITY_TYPE must be one of:
 

gcloud/alpha/alloydb/instances/create-secondary

@@ -5,9 +5,9 @@ NAME
 SYNOPSIS
     gcloud alpha alloydb instances create-secondary INSTANCE --cluster=CLUSTER
         --region=REGION [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP]
-        [--async] [--availability-type=AVAILABILITY_TYPE]
-        [--[no-]require-connectors] [--ssl-mode=SSL_MODE]
-        [GCLOUD_WIDE_FLAG ...]
+        [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]]
+        [--availability-type=AVAILABILITY_TYPE] [--[no-]require-connectors]
+        [--ssl-mode=SSL_MODE] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     (ALPHA) Creates a new AlloyDB SECONDARY instance within a given cluster.
@@ -32,19 +32,25 @@ REQUIRED FLAGS
 
 OPTIONAL FLAGS
      --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP
-        Specify to enable or disable public IP on an instance. On instance
-        creation only disabling public IP is allowed. If you want to enable
-        public IP, an instance must be created with public IP disabled first,
-        then update the instance to enable public IP. ASSIGN_INBOUND_PUBLIC_IP
-        must be (only one value is supported):
-
-         NO_PUBLIC_IP
-            This disables public IP on the instance.
+        Specify to enable or disable public IP on an instance.
+        ASSIGN_INBOUND_PUBLIC_IP must be one of:
+        ◆ NO_PUBLIC_IP
+          ▸ This disables public IP on the instance. Updating an instance to
+            disable public IP will clear the list of authorized networks.
+        ◆ ASSIGN_IPV4
+          ▸ Assign an inbound public IPv4 address for the instance. Public IP
+            is enabled.
 
      --async
         Return immediately, without waiting for the operation in progress to
         complete.
 
+     --authorized-external-networks=[AUTHORIZED_NETWORK,...]
+        Comma-separated list of authorized external networks to set on the
+        instance. Authorized networks should use CIDR notation (e.g.
+        1.2.3.4/30). This flag is only allowed to be set for instances with
+        public IP enabled.
+
      --availability-type=AVAILABILITY_TYPE
         Specifies level of availability. AVAILABILITY_TYPE must be one of:
 

gcloud/alpha/alloydb/instances/update

@@ -53,7 +53,7 @@ OPTIONAL FLAGS
           ▸ This disables public IP on the instance. Updating an instance to
             disable public IP will clear the list of authorized networks.
         ◆ ASSIGN_IPV4
-          ▸ Assign an inbound public IPv4 address for the instance. public IP
+          ▸ Assign an inbound public IPv4 address for the instance. Public IP
             is enabled.
 
      --async