gcloud: Wed Jul 12 10:20:16 UTC 2023

gcloud/beta/compute/backend-services/update-backend

@@ -11,7 +11,8 @@ SYNOPSIS
           : --network-endpoint-group-zone=NETWORK_ENDPOINT_GROUP_ZONE])
         [--balancing-mode=BALANCING_MODE] [--capacity-scaler=CAPACITY_SCALER]
         [--description=DESCRIPTION] [--failover]
-        [--max-utilization=MAX_UTILIZATION] [--global | --region=REGION]
+        [--max-utilization=MAX_UTILIZATION] [--preference=PREFERENCE]
+        [--global | --region=REGION]
         [--max-connections=MAX_CONNECTIONS
           | --max-connections-per-endpoint=MAX_CONNECTIONS_PER_ENDPOINT
           | --max-connections-per-instance=MAX_CONNECTIONS_PER_INSTANCE
@@ -201,6 +202,23 @@ OPTIONAL FLAGS
         capacity. For usage guidelines, see Balancing mode combinations
         (https://cloud.google.com/load-balancing/docs/backend-service#balancing-mode-combos).
 
+     --preference=PREFERENCE
+        Defines whether a backend should be fully utilized before sending
+        traffic to backends with default preference. This parameter cannot be
+        used with regional managed instance groups and when the endpoint type
+        of an attached network endpoint group is INTERNET_IP_PORT,
+        INTERNET_FQDN_PORT, or SERVERLESS. PREFERENCE must be one of:
+
+         DEFAULT
+            This is the default setting. If the designated preferred backends
+            don't have enough capacity, backends in the default category are
+            used. Traffic is distributed between default backends based on the
+            load balancing algorithm you use.
+
+         PREFERRED
+            Backends with this preference setting are used up to their capacity
+            limits first, while optimizing overall network latency.
+
      At most one of these can be specified:
 
        --global