You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: scripts/generate-google3-docs/resource-reference/generated/resource-docs/compute/computebackendservice.md
+54-5Lines changed: 54 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -889,7 +889,29 @@ timeoutSec: integer
889
889
</td>
890
890
<td>
891
891
<p><code class="apitype">string</code></p>
892
-
<p>Specifies connection persistence when backends are unhealthy. The default value is DEFAULT_FOR_PROTOCOL. If set to DEFAULT_FOR_PROTOCOL, the existing connections persist on unhealthy backends only for connection-oriented protocols (TCP and SCTP) and only if the Tracking Mode is PER_CONNECTION (default tracking mode) or the Session Affinity is configured for 5-tuple. They do not persist for UDP. If set to NEVER_PERSIST, after a backend becomes unhealthy, the existing connections on the unhealthy backend are never persisted on the unhealthy backend. They are always diverted to newly selected healthy backends (unless all backends are unhealthy). If set to ALWAYS_PERSIST, existing connections always persist on unhealthy backends regardless of protocol and session affinity. It is generally not recommended to use this mode overriding the default. For more details, see [Connection Persistence for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) and [Connection Persistence for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence). Check the ConnectionPersistenceOnUnhealthyBackends enum for the list of possible values.</p>
892
+
<p>Specifies connection persistence when backends are unhealthy. The default
893
+
value is DEFAULT_FOR_PROTOCOL.
894
+
895
+
If set to DEFAULT_FOR_PROTOCOL, the existing connections
896
+
persist on unhealthy backends only for connection-oriented protocols
897
+
(TCP and SCTP) and only if the Tracking Mode isPER_CONNECTION (default tracking mode) or the Session
898
+
Affinity is configured for 5-tuple. They do not persist forUDP.
899
+
900
+
If set to NEVER_PERSIST, after a backend becomes unhealthy,
901
+
the existing connections on the unhealthy backend are never persisted on
902
+
the unhealthy backend. They are always diverted to newly selected healthy
903
+
backends (unless all backends are unhealthy).
904
+
905
+
If set to ALWAYS_PERSIST, existing connections always
906
+
persist on unhealthy backends regardless of protocol and session
907
+
affinity. It is generally not recommended to use this mode overriding the
908
+
default.
909
+
910
+
For more details, see [Connection Persistence for Network Load
Check the ConnectionPersistenceOnUnhealthyBackends enum for the list of possible values.</p>
893
915
</td>
894
916
</tr>
895
917
<tr>
@@ -909,7 +931,18 @@ timeoutSec: integer
909
931
</td>
910
932
<td>
911
933
<p><code class="apitype">integer</code></p>
912
-
<p>Specifies how long to keep a Connection Tracking entry while there is no matching traffic (in seconds). For internal passthrough Network Load Balancers: - The minimum (default) is 10 minutes and the maximum is 16 hours. - It can be set only if Connection Tracking is less than 5-tuple (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION, CLIENT_IP or CLIENT_IP_PROTO, and Tracking Mode is PER_SESSION). For external passthrough Network Load Balancers the default is 60 seconds. This option is not available publicly.</p>
934
+
<p>Specifies how long to keep a Connection Tracking entry while there is no
935
+
matching traffic (in seconds).
936
+
937
+
For internal passthrough Network Load Balancers:
938
+
939
+
- The minimum (default) is 10 minutes and the maximum is 16 hours.
940
+
- It can be set only if Connection Tracking is less than 5-tuple
941
+
(i.e. Session Affinity is CLIENT_IP_NO_DESTINATION,CLIENT_IP or CLIENT_IP_PROTO, and Tracking
942
+
Mode is PER_SESSION).
943
+
944
+
For external passthrough Network Load Balancers the default is 60
945
+
seconds. This option is not available publicly.</p>
913
946
</td>
914
947
</tr>
915
948
<tr>
@@ -919,7 +952,21 @@ timeoutSec: integer
919
952
</td>
920
953
<td>
921
954
<p><code class="apitype">string</code></p>
922
-
<p>Specifies the key used for connection tracking. There are two options: - PER_CONNECTION: This is the default mode. The Connection Tracking is performed as per the Connection Key (default Hash Method) for the specific protocol. - PER_SESSION: The Connection Tracking is performed as per the configured Session Affinity. It matches the configured Session Affinity. For more details, see [Tracking Mode for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) and [Tracking Mode for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode). Check the TrackingMode enum for the list of possible values.</p>
955
+
<p>Specifies the key used for connection tracking. There are two
956
+
options:
957
+
958
+
- PER_CONNECTION: This is the default mode. The Connection
959
+
Tracking is performed as per the Connection Key (default Hash Method) for
960
+
the specific protocol.
961
+
- PER_SESSION: The Connection Tracking is performed as per
962
+
the configured Session Affinity. It matches the configured Session
963
+
Affinity.
964
+
965
+
For more details, see [Tracking Mode for Network Load
Check the TrackingMode enum for the list of possible values.</p>
923
970
</td>
924
971
</tr>
925
972
<tr>
@@ -1129,7 +1176,9 @@ timeoutSec: integer
1129
1176
</td>
1130
1177
<td>
1131
1178
<p><code class="apitype">boolean</code></p>
1132
-
<p>This can be set to true only if the protocol is TCP. The default is false.</p>
1179
+
<p>This can be set to true if the protocol isTCP, UDP, or UNSPECIFIED.
1180
+
1181
+
The default is false.</p>
1133
1182
</td>
1134
1183
</tr>
1135
1184
<tr>
@@ -1149,7 +1198,7 @@ timeoutSec: integer
1149
1198
</td>
1150
1199
<td>
1151
1200
<p><code class="apitype">float</code></p>
1152
-
<p>The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a failover when the number of healthy primary VMs equals zero. For all other values, the load balancer performs a failover when the total number of healthy primary VMs is less than this ratio. For load balancers that have configurable failover: [Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).</p>
1201
+
<p>The value of the field must be in the range[0, 1]. If the value is 0, the load balancer performs a failover when the number of healthy primary VMs equals zero. For all other values, the load balancer performs a failover when the total number of healthy primary VMs is less than this ratio. For load balancers that have configurable failover: [Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).</p>
0 commit comments