Interface BackendServiceOrBuilder (1.88.0)

Version latest

• 1.86.0 (latest)
• 1.85.0
• 1.84.0
• 1.83.0
• 1.82.0
• 1.80.0
• 1.78.0
• 1.77.0
• 1.74.0
• 1.73.0
• 1.72.0
• 1.70.0
• 1.69.0
• 1.68.0
• 1.67.0
• 1.66.0
• 1.65.0
• 1.64.0
• 1.63.0
• 1.62.0
• 1.61.0
• 1.59.0
• 1.58.0
• 1.57.0
• 1.56.0
• 1.55.0
• 1.54.0
• 1.53.0
• 1.52.0
• 1.51.0
• 1.50.0
• 1.49.0
• 1.47.0
• 1.46.0
• 1.45.0
• 1.44.0
• 1.43.0
• 1.42.0
• 1.41.0
• 1.40.0
• 1.39.0
• 1.38.0
• 1.37.0
• 1.34.0
• 1.33.0
• 1.32.0
• 1.31.0
• 1.30.0
• 1.29.0
• 1.28.0
• 1.27.0
• 1.26.0
• 1.25.0
• 1.24.0
• 1.23.0
• 1.22.0
• 1.21.0
• 1.20.0
• 1.19.0
• 1.18.0
• 1.17.0
• 1.16.0
• 1.15.0
• 1.14.0
• 1.13.0
• 1.12.1
• 1.11.0
• 1.9.1
• 1.8.1
• 1.7.2
• 1.6.0-beta

public interface BackendServiceOrBuilder extends MessageOrBuilder

Implements

MessageOrBuilder

Methods

containsMetadatas(String key)

public abstract boolean containsMetadatas(String key)

Deployment metadata associated with the resource to be set by a GKE hub controller and read by the backend RCTH

map<string, string> metadatas = 8514340;

Parameter
Name	Description
key	String

Returns
Type	Description
boolean

getAffinityCookieTtlSec()

public abstract int getAffinityCookieTtlSec()

Lifetime of cookies in seconds. This setting is applicable to Application Load Balancers and Traffic Director and requires GENERATED_COOKIE or HTTP_COOKIE session affinity. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value is two weeks (1,209,600). Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.

optional int32 affinity_cookie_ttl_sec = 369996954;

Returns
Type	Description
int	The affinityCookieTtlSec.

getBackends(int index)

public abstract Backend getBackends(int index)

The list of backends that serve this BackendService.

repeated .google.cloud.compute.v1.Backend backends = 510839903;

Parameter
Name	Description
index	int

Returns
Type	Description
Backend

getBackendsCount()

public abstract int getBackendsCount()

The list of backends that serve this BackendService.

repeated .google.cloud.compute.v1.Backend backends = 510839903;

Returns
Type	Description
int

getBackendsList()

public abstract List<Backend> getBackendsList()

The list of backends that serve this BackendService.

repeated .google.cloud.compute.v1.Backend backends = 510839903;

Returns
Type	Description
List<Backend>

getBackendsOrBuilder(int index)

public abstract BackendOrBuilder getBackendsOrBuilder(int index)

The list of backends that serve this BackendService.

repeated .google.cloud.compute.v1.Backend backends = 510839903;

Parameter
Name	Description
index	int

Returns
Type	Description
BackendOrBuilder

getBackendsOrBuilderList()

public abstract List<? extends BackendOrBuilder> getBackendsOrBuilderList()

The list of backends that serve this BackendService.

repeated .google.cloud.compute.v1.Backend backends = 510839903;

Returns
Type	Description
List<? extends com.google.cloud.compute.v1.BackendOrBuilder>

getCdnPolicy()

public abstract BackendServiceCdnPolicy getCdnPolicy()

Cloud CDN configuration for this BackendService. Only available for specified load balancer types.

optional .google.cloud.compute.v1.BackendServiceCdnPolicy cdn_policy = 213976452;

Returns
Type	Description
BackendServiceCdnPolicy	The cdnPolicy.

getCdnPolicyOrBuilder()

public abstract BackendServiceCdnPolicyOrBuilder getCdnPolicyOrBuilder()

Cloud CDN configuration for this BackendService. Only available for specified load balancer types.

optional .google.cloud.compute.v1.BackendServiceCdnPolicy cdn_policy = 213976452;

Returns
Type	Description
BackendServiceCdnPolicyOrBuilder

getCircuitBreakers()

public abstract CircuitBreakers getCircuitBreakers()

optional .google.cloud.compute.v1.CircuitBreakers circuit_breakers = 421340061;

Returns
Type	Description
CircuitBreakers	The circuitBreakers.

getCircuitBreakersOrBuilder()

public abstract CircuitBreakersOrBuilder getCircuitBreakersOrBuilder()

optional .google.cloud.compute.v1.CircuitBreakers circuit_breakers = 421340061;

Returns
Type	Description
CircuitBreakersOrBuilder

getCompressionMode()

public abstract String getCompressionMode()

Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. Check the CompressionMode enum for the list of possible values.

optional string compression_mode = 95520988;

Returns
Type	Description
String	The compressionMode.

getCompressionModeBytes()

public abstract ByteString getCompressionModeBytes()

Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. Check the CompressionMode enum for the list of possible values.

optional string compression_mode = 95520988;

Returns
Type	Description
ByteString	The bytes for compressionMode.

getConnectionDraining()

public abstract ConnectionDraining getConnectionDraining()

connectionDraining cannot be specified with haPolicy.

optional .google.cloud.compute.v1.ConnectionDraining connection_draining = 461096747;

Returns
Type	Description
ConnectionDraining	The connectionDraining.

getConnectionDrainingOrBuilder()

public abstract ConnectionDrainingOrBuilder getConnectionDrainingOrBuilder()

connectionDraining cannot be specified with haPolicy.

optional .google.cloud.compute.v1.ConnectionDraining connection_draining = 461096747;

Returns
Type	Description
ConnectionDrainingOrBuilder

getConnectionTrackingPolicy()

public abstract BackendServiceConnectionTrackingPolicy getConnectionTrackingPolicy()

Connection Tracking configuration for this BackendService. Connection tracking policy settings are only available for external passthrough Network Load Balancers and internal passthrough Network Load Balancers. connectionTrackingPolicy cannot be specified with haPolicy.

optional .google.cloud.compute.v1.BackendServiceConnectionTrackingPolicy connection_tracking_policy = 143994969;

Returns
Type	Description
BackendServiceConnectionTrackingPolicy	The connectionTrackingPolicy.

getConnectionTrackingPolicyOrBuilder()

public abstract BackendServiceConnectionTrackingPolicyOrBuilder getConnectionTrackingPolicyOrBuilder()

Connection Tracking configuration for this BackendService. Connection tracking policy settings are only available for external passthrough Network Load Balancers and internal passthrough Network Load Balancers. connectionTrackingPolicy cannot be specified with haPolicy.

optional .google.cloud.compute.v1.BackendServiceConnectionTrackingPolicy connection_tracking_policy = 143994969;

Returns
Type	Description
BackendServiceConnectionTrackingPolicyOrBuilder

getConsistentHash()

public abstract ConsistentHashLoadBalancerSettings getConsistentHash()

Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. This load balancing policy is applicable only for HTTP connections. The affinity to a particular destination host will be lost when one or more hosts are added/removed from the destination service. This field specifies parameters that control consistent hashing. This field is only applicable when localityLbPolicy is set to MAGLEV or RING_HASH. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED.

optional .google.cloud.compute.v1.ConsistentHashLoadBalancerSettings consistent_hash = 905883;

Returns
Type	Description
ConsistentHashLoadBalancerSettings	The consistentHash.

getConsistentHashOrBuilder()

public abstract ConsistentHashLoadBalancerSettingsOrBuilder getConsistentHashOrBuilder()

Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. This load balancing policy is applicable only for HTTP connections. The affinity to a particular destination host will be lost when one or more hosts are added/removed from the destination service. This field specifies parameters that control consistent hashing. This field is only applicable when localityLbPolicy is set to MAGLEV or RING_HASH. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED.

optional .google.cloud.compute.v1.ConsistentHashLoadBalancerSettings consistent_hash = 905883;

Returns
Type	Description
ConsistentHashLoadBalancerSettingsOrBuilder

getCreationTimestamp()

public abstract String getCreationTimestamp()

[Output Only] Creation timestamp in RFC3339 text format.

optional string creation_timestamp = 30525366;

Returns
Type	Description
String	The creationTimestamp.

getCreationTimestampBytes()

public abstract ByteString getCreationTimestampBytes()

[Output Only] Creation timestamp in RFC3339 text format.

optional string creation_timestamp = 30525366;

Returns
Type	Description
ByteString	The bytes for creationTimestamp.

getCustomMetrics(int index)

public abstract BackendServiceCustomMetric getCustomMetrics(int index)

List of custom metrics that are used for the WEIGHTED_ROUND_ROBIN locality_lb_policy.

repeated .google.cloud.compute.v1.BackendServiceCustomMetric custom_metrics = 429453813;

Parameter
Name	Description
index	int

Returns
Type	Description
BackendServiceCustomMetric

getCustomMetricsCount()

public abstract int getCustomMetricsCount()

List of custom metrics that are used for the WEIGHTED_ROUND_ROBIN locality_lb_policy.

repeated .google.cloud.compute.v1.BackendServiceCustomMetric custom_metrics = 429453813;

Returns
Type	Description
int

getCustomMetricsList()

public abstract List<BackendServiceCustomMetric> getCustomMetricsList()

List of custom metrics that are used for the WEIGHTED_ROUND_ROBIN locality_lb_policy.

repeated .google.cloud.compute.v1.BackendServiceCustomMetric custom_metrics = 429453813;

Returns
Type	Description
List<BackendServiceCustomMetric>

getCustomMetricsOrBuilder(int index)

public abstract BackendServiceCustomMetricOrBuilder getCustomMetricsOrBuilder(int index)

List of custom metrics that are used for the WEIGHTED_ROUND_ROBIN locality_lb_policy.

repeated .google.cloud.compute.v1.BackendServiceCustomMetric custom_metrics = 429453813;

Parameter
Name	Description
index	int

Returns
Type	Description
BackendServiceCustomMetricOrBuilder

getCustomMetricsOrBuilderList()

public abstract List<? extends BackendServiceCustomMetricOrBuilder> getCustomMetricsOrBuilderList()

List of custom metrics that are used for the WEIGHTED_ROUND_ROBIN locality_lb_policy.

repeated .google.cloud.compute.v1.BackendServiceCustomMetric custom_metrics = 429453813;

Returns
Type	Description
List<? extends com.google.cloud.compute.v1.BackendServiceCustomMetricOrBuilder>

getCustomRequestHeaders(int index)

public abstract String getCustomRequestHeaders(int index)

Headers that the load balancer adds to proxied requests. See Creating custom headers.

repeated string custom_request_headers = 27977992;

Parameter
Name	Description
index	int The index of the element to return.

Returns
Type	Description
String	The customRequestHeaders at the given index.

getCustomRequestHeadersBytes(int index)

public abstract ByteString getCustomRequestHeadersBytes(int index)

Headers that the load balancer adds to proxied requests. See Creating custom headers.

repeated string custom_request_headers = 27977992;

Parameter
Name	Description
index	int The index of the value to return.

Returns
Type	Description
ByteString	The bytes of the customRequestHeaders at the given index.

getCustomRequestHeadersCount()

public abstract int getCustomRequestHeadersCount()

Headers that the load balancer adds to proxied requests. See Creating custom headers.

repeated string custom_request_headers = 27977992;

Returns
Type	Description
int	The count of customRequestHeaders.

getCustomRequestHeadersList()

public abstract List<String> getCustomRequestHeadersList()

Headers that the load balancer adds to proxied requests. See Creating custom headers.

repeated string custom_request_headers = 27977992;

Returns
Type	Description
List<String>	A list containing the customRequestHeaders.

getCustomResponseHeaders(int index)

public abstract String getCustomResponseHeaders(int index)

Headers that the load balancer adds to proxied responses. See Creating custom headers.

repeated string custom_response_headers = 387539094;

Parameter
Name	Description
index	int The index of the element to return.

Returns
Type	Description
String	The customResponseHeaders at the given index.

getCustomResponseHeadersBytes(int index)

public abstract ByteString getCustomResponseHeadersBytes(int index)

Headers that the load balancer adds to proxied responses. See Creating custom headers.

repeated string custom_response_headers = 387539094;

Parameter
Name	Description
index	int The index of the value to return.

Returns
Type	Description
ByteString	The bytes of the customResponseHeaders at the given index.

getCustomResponseHeadersCount()

public abstract int getCustomResponseHeadersCount()

Headers that the load balancer adds to proxied responses. See Creating custom headers.

repeated string custom_response_headers = 387539094;

Returns
Type	Description
int	The count of customResponseHeaders.

getCustomResponseHeadersList()

public abstract List<String> getCustomResponseHeadersList()

Headers that the load balancer adds to proxied responses. See Creating custom headers.

repeated string custom_response_headers = 387539094;

Returns
Type	Description
List<String>	A list containing the customResponseHeaders.

getDescription()

public abstract String getDescription()

An optional description of this resource. Provide this property when you create the resource.

optional string description = 422937596;

Returns
Type	Description
String	The description.

getDescriptionBytes()

public abstract ByteString getDescriptionBytes()

An optional description of this resource. Provide this property when you create the resource.

optional string description = 422937596;

Returns
Type	Description
ByteString	The bytes for description.

getEdgeSecurityPolicy()

public abstract String getEdgeSecurityPolicy()

[Output Only] The resource URL for the edge security policy associated with this backend service.

optional string edge_security_policy = 41036943;

Returns
Type	Description
String	The edgeSecurityPolicy.

getEdgeSecurityPolicyBytes()

public abstract ByteString getEdgeSecurityPolicyBytes()

[Output Only] The resource URL for the edge security policy associated with this backend service.

optional string edge_security_policy = 41036943;

Returns
Type	Description
ByteString	The bytes for edgeSecurityPolicy.

getEnableCDN()

public abstract boolean getEnableCDN()

If true, enables Cloud CDN for the backend service of a global external Application Load Balancer.

optional bool enable_c_d_n = 250733499;

Returns
Type	Description
boolean	The enableCDN.

getExternalManagedMigrationState()

public abstract String getExternalManagedMigrationState()

Specifies the canary migration state. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using externalManagedMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. Check the ExternalManagedMigrationState enum for the list of possible values.

optional string external_managed_migration_state = 66947020;

Returns
Type	Description
String	The externalManagedMigrationState.

getExternalManagedMigrationStateBytes()

public abstract ByteString getExternalManagedMigrationStateBytes()

Specifies the canary migration state. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using externalManagedMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL. Check the ExternalManagedMigrationState enum for the list of possible values.

optional string external_managed_migration_state = 66947020;

Returns
Type	Description
ByteString	The bytes for externalManagedMigrationState.

getExternalManagedMigrationTestingPercentage()

public abstract float getExternalManagedMigrationTestingPercentage()

Determines the fraction of requests that should be processed by the Global external Application Load Balancer. The value of this field must be in the range [0, 100]. Session affinity options will slightly affect this routing behavior, for more details, see: Session Affinity. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE.

optional float external_managed_migration_testing_percentage = 507232462;

Returns
Type	Description
float	The externalManagedMigrationTestingPercentage.