BackendService (Compute Engine API v1-rev20190825-1.28.0)

java.lang.Object
- java.util.AbstractMap<String,Object>
- - com.google.api.client.util.GenericData
  - - com.google.api.client.json.GenericJson
    - - com.google.api.services.compute.model.BackendService

All Implemented Interfaces:

Cloneable, Map<String,Object>
```
public final class BackendService
extends GenericJson
```
Represents a Backend Service resource. Backend services must have an associated health check. Backend services also store information about session affinity. For more information, read Backend Services. A backendServices resource represents a global backend service. Global backend services are used for HTTP(S), SSL Proxy, TCP Proxy load balancing and Traffic Director. A regionBackendServices resource represents a regional backend service. Regional backend services are used for internal TCP/UDP load balancing. For more information, read Internal TCP/UDP Load balancing. (== resource_for v1.backendService ==) (== resource_for beta.backendService ==)
This is the Java data model class that specifies how to parse/serialize into the JSON that is transmitted over HTTP when working with the Compute Engine API. For a detailed explanation see: https://developers.google.com/api-client-library/java/google-http-java-client/json

Author:

Google, Inc.

Nested Class Summary
- Nested classes/interfaces inherited from class com.google.api.client.util.GenericData
  GenericData.Flags
- Nested classes/interfaces inherited from class java.util.AbstractMap
  AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>
- Nested classes/interfaces inherited from interface java.util.Map
  Map.Entry<K,V>

Constructor Summary

Constructors
Constructor and Description

BackendService()

Constructors
Constructor and Description
`BackendService()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`BackendService`	`clone()`
`byte[]`	`decodeFingerprint()` Fingerprint of this resource.
`BackendService`	`encodeFingerprint(byte[] fingerprint)` Fingerprint of this resource.
`Integer`	`getAffinityCookieTtlSec()` If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent).
`List<Backend>`	`getBackends()` The list of backends that serve this BackendService.
`BackendServiceCdnPolicy`	`getCdnPolicy()` Cloud CDN configuration for this BackendService.
`ConnectionDraining`	`getConnectionDraining()`
`String`	`getCreationTimestamp()` [Output Only] Creation timestamp in RFC3339 text format.
`List<String>`	`getCustomRequestHeaders()` Headers that the HTTP/S load balancer should add to proxied requests.
`String`	`getDescription()` An optional description of this resource.
`Boolean`	`getEnableCDN()` If true, enables Cloud CDN for the backend service.
`String`	`getFingerprint()` Fingerprint of this resource.
`List<String>`	`getHealthChecks()` The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService.
`BackendServiceIAP`	`getIap()`
`BigInteger`	`getId()` [Output Only] The unique identifier for the resource.
`String`	`getKind()` [Output Only] Type of resource.
`String`	`getLoadBalancingScheme()` Indicates whether the backend service will be used with internal or external load balancing.
`String`	`getName()` Name of the resource.
`Integer`	`getPort()` Deprecated in favor of portName.
`String`	`getPortName()` A named port on a backend instance group representing the port for communication to the backend VMs in that group.
`String`	`getProtocol()` The protocol this BackendService uses to communicate with backends.
`String`	`getRegion()` [Output Only] URL of the region where the regional backend service resides.
`String`	`getSecurityPolicy()` [Output Only] The resource URL for the security policy associated with this backend service.
`String`	`getSelfLink()` [Output Only] Server-defined URL for the resource.
`String`	`getSessionAffinity()` Type of session affinity to use.
`Integer`	`getTimeoutSec()` The backend service timeout has a different meaning depending on the type of load balancer.
`BackendService`	`set(String fieldName, Object value)`
`BackendService`	`setAffinityCookieTtlSec(Integer affinityCookieTtlSec)` If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent).
`BackendService`	`setBackends(List<Backend> backends)` The list of backends that serve this BackendService.
`BackendService`	`setCdnPolicy(BackendServiceCdnPolicy cdnPolicy)` Cloud CDN configuration for this BackendService.
`BackendService`	`setConnectionDraining(ConnectionDraining connectionDraining)`
`BackendService`	`setCreationTimestamp(String creationTimestamp)` [Output Only] Creation timestamp in RFC3339 text format.
`BackendService`	`setCustomRequestHeaders(List<String> customRequestHeaders)` Headers that the HTTP/S load balancer should add to proxied requests.
`BackendService`	`setDescription(String description)` An optional description of this resource.
`BackendService`	`setEnableCDN(Boolean enableCDN)` If true, enables Cloud CDN for the backend service.
`BackendService`	`setFingerprint(String fingerprint)` Fingerprint of this resource.
`BackendService`	`setHealthChecks(List<String> healthChecks)` The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService.
`BackendService`	`setIap(BackendServiceIAP iap)`
`BackendService`	`setId(BigInteger id)` [Output Only] The unique identifier for the resource.
`BackendService`	`setKind(String kind)` [Output Only] Type of resource.
`BackendService`	`setLoadBalancingScheme(String loadBalancingScheme)` Indicates whether the backend service will be used with internal or external load balancing.
`BackendService`	`setName(String name)` Name of the resource.
`BackendService`	`setPort(Integer port)` Deprecated in favor of portName.
`BackendService`	`setPortName(String portName)` A named port on a backend instance group representing the port for communication to the backend VMs in that group.
`BackendService`	`setProtocol(String protocol)` The protocol this BackendService uses to communicate with backends.
`BackendService`	`setRegion(String region)` [Output Only] URL of the region where the regional backend service resides.
`BackendService`	`setSecurityPolicy(String securityPolicy)` [Output Only] The resource URL for the security policy associated with this backend service.
`BackendService`	`setSelfLink(String selfLink)` [Output Only] Server-defined URL for the resource.
`BackendService`	`setSessionAffinity(String sessionAffinity)` Type of session affinity to use.
`BackendService`	`setTimeoutSec(Integer timeoutSec)` The backend service timeout has a different meaning depending on the type of load balancer.

Methods inherited from class com.google.api.client.json.GenericJson
getFactory, setFactory, toPrettyString, toString

Methods inherited from class com.google.api.client.util.GenericData
entrySet, get, getClassInfo, getUnknownKeys, put, putAll, remove, setUnknownKeys

Methods inherited from class java.util.AbstractMap
clear, containsKey, containsValue, equals, hashCode, isEmpty, keySet, size, values

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

- Constructor Detail
  - BackendService
```
public BackendService()
```
- Method Detail
  - getAffinityCookieTtlSec
```
public Integer getAffinityCookieTtlSec()
```
    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 one day (86,400).
    
    Returns:
    
    value or null for none
  - setAffinityCookieTtlSec
```
public BackendService setAffinityCookieTtlSec(Integer affinityCookieTtlSec)
```
    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 one day (86,400).
    
    Parameters:
    
    affinityCookieTtlSec - affinityCookieTtlSec or null for none
  - getBackends
```
public List<Backend> getBackends()
```
    The list of backends that serve this BackendService.
    
    Returns:
    
    value or null for none
  - setBackends
```
public BackendService setBackends(List<Backend> backends)
```
    The list of backends that serve this BackendService.
    
    Parameters:
    
    backends - backends or null for none
  - getCdnPolicy
```
public BackendServiceCdnPolicy getCdnPolicy()
```
    Cloud CDN configuration for this BackendService.
    
    Returns:
    
    value or null for none
  - setCdnPolicy
```
public BackendService setCdnPolicy(BackendServiceCdnPolicy cdnPolicy)
```
    Cloud CDN configuration for this BackendService.
    
    Parameters:
    
    cdnPolicy - cdnPolicy or null for none
  - getConnectionDraining
```
public ConnectionDraining getConnectionDraining()
```
    Returns:
    
    value or null for none
  - setConnectionDraining
```
public BackendService setConnectionDraining(ConnectionDraining connectionDraining)
```
    Parameters:
    
    connectionDraining - connectionDraining or null for none
  - getCreationTimestamp
```
public String getCreationTimestamp()
```
    [Output Only] Creation timestamp in RFC3339 text format.
    
    Returns:
    
    value or null for none
  - setCreationTimestamp
```
public BackendService setCreationTimestamp(String creationTimestamp)
```
    [Output Only] Creation timestamp in RFC3339 text format.
    
    Parameters:
    
    creationTimestamp - creationTimestamp or null for none
  - getCustomRequestHeaders
```
public List<String> getCustomRequestHeaders()
```
    Headers that the HTTP/S load balancer should add to proxied requests.
    
    Returns:
    
    value or null for none
  - setCustomRequestHeaders
```
public BackendService setCustomRequestHeaders(List<String> customRequestHeaders)
```
    Headers that the HTTP/S load balancer should add to proxied requests.
    
    Parameters:
    
    customRequestHeaders - customRequestHeaders or null for none
  - getDescription
```
public String getDescription()
```
    An optional description of this resource. Provide this property when you create the resource.
    
    Returns:
    
    value or null for none
  - setDescription
```
public BackendService setDescription(String description)
```
    An optional description of this resource. Provide this property when you create the resource.
    
    Parameters:
    
    description - description or null for none
  - getEnableCDN
```
public Boolean getEnableCDN()
```
    If true, enables Cloud CDN for the backend service. Only applicable if the loadBalancingScheme is EXTERNAL and the protocol is HTTP or HTTPS.
    
    Returns:
    
    value or null for none
  - setEnableCDN
```
public BackendService setEnableCDN(Boolean enableCDN)
```
    If true, enables Cloud CDN for the backend service. Only applicable if the loadBalancingScheme is EXTERNAL and the protocol is HTTP or HTTPS.
    
    Parameters:
    
    enableCDN - enableCDN or null for none
  - getFingerprint
```
public String getFingerprint()
```
    Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to- date fingerprint must be provided in order to update the BackendService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a BackendService.
    
    Returns:
    
    value or null for none
    
    See Also:
    
    decodeFingerprint()
  - decodeFingerprint
```
public byte[] decodeFingerprint()
```
    Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to- date fingerprint must be provided in order to update the BackendService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a BackendService.
    
    Returns:
    
    Base64 decoded value or null for none
    
    Since:
    
    1.14
    
    See Also:
    
    getFingerprint()
  - setFingerprint
```
public BackendService setFingerprint(String fingerprint)
```
    Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to- date fingerprint must be provided in order to update the BackendService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a BackendService.
    
    Parameters:
    
    fingerprint - fingerprint or null for none
    
    See Also:
    
    #encodeFingerprint()
  - encodeFingerprint
```
public BackendService encodeFingerprint(byte[] fingerprint)
```
    Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a BackendService. An up-to- date fingerprint must be provided in order to update the BackendService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a BackendService.
    
    Since:
    
    1.14
    
    See Also:
    
    The value is encoded Base64 or {@code null} for none.
  - getHealthChecks
```
public List<String> getHealthChecks()
```
    The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService. Currently at most one health check can be specified, and a health check is required for Compute Engine backend services. A health check must not be specified for App Engine backend and Cloud Function backend. For internal load balancing, a URL to a HealthCheck resource must be specified instead.
    
    Returns:
    
    value or null for none
  - setHealthChecks
```
public BackendService setHealthChecks(List<String> healthChecks)
```
    The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService. Currently at most one health check can be specified, and a health check is required for Compute Engine backend services. A health check must not be specified for App Engine backend and Cloud Function backend. For internal load balancing, a URL to a HealthCheck resource must be specified instead.
    
    Parameters:
    
    healthChecks - healthChecks or null for none
  - getIap
```
public BackendServiceIAP getIap()
```
    Returns:
    
    value or null for none
  - setIap
```
public BackendService setIap(BackendServiceIAP iap)
```
    Parameters:
    
    iap - iap or null for none
  - getId
```
public BigInteger getId()
```
    [Output Only] The unique identifier for the resource. This identifier is defined by the server.
    
    Returns:
    
    value or null for none
  - setId
```
public BackendService setId(BigInteger id)
```
    [Output Only] The unique identifier for the resource. This identifier is defined by the server.
    
    Parameters:
    
    id - id or null for none
  - getKind
```
public String getKind()
```
    [Output Only] Type of resource. Always compute#backendService for backend services.
    
    Returns:
    
    value or null for none
  - setKind
```
public BackendService setKind(String kind)
```
    [Output Only] Type of resource. Always compute#backendService for backend services.
    
    Parameters:
    
    kind - kind or null for none
  - getLoadBalancingScheme
```
public String getLoadBalancingScheme()
```
    Indicates whether the backend service will be used with internal or external load balancing. A backend service created for one type of load balancing cannot be used with the other. Possible values are INTERNAL and EXTERNAL.
    
    Returns:
    
    value or null for none
  - setLoadBalancingScheme
```
public BackendService setLoadBalancingScheme(String loadBalancingScheme)
```
    Indicates whether the backend service will be used with internal or external load balancing. A backend service created for one type of load balancing cannot be used with the other. Possible values are INTERNAL and EXTERNAL.
    
    Parameters:
    
    loadBalancingScheme - loadBalancingScheme or null for none
  - getName
```
public String getName()
```
    Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
    
    Returns:
    
    value or null for none
  - setName
```
public BackendService setName(String name)
```
    Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
    
    Parameters:
    
    name - name or null for none
  - getPort
```
public Integer getPort()
```
    Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. This cannot be used if the loadBalancingScheme is INTERNAL (Internal TCP/UDP Load Balancing).
    
    Returns:
    
    value or null for none
  - setPort
```
public BackendService setPort(Integer port)
```
    Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. This cannot be used if the loadBalancingScheme is INTERNAL (Internal TCP/UDP Load Balancing).
    
    Parameters:
    
    port - port or null for none
  - getPortName
```
public String getPortName()
```
    A named port on a backend instance group representing the port for communication to the backend VMs in that group. Required when the loadBalancingScheme is EXTERNAL and the backends are instance groups. The named port must be defined on each backend instance group. This parameter has no meaning if the backends are NEGs. Must be omitted when the loadBalancingScheme is INTERNAL (Internal TCP/UDP Load Blaancing).
    
    Returns:
    
    value or null for none
  - setPortName
```
public BackendService setPortName(String portName)
```
    A named port on a backend instance group representing the port for communication to the backend VMs in that group. Required when the loadBalancingScheme is EXTERNAL and the backends are instance groups. The named port must be defined on each backend instance group. This parameter has no meaning if the backends are NEGs. Must be omitted when the loadBalancingScheme is INTERNAL (Internal TCP/UDP Load Blaancing).
    
    Parameters:
    
    portName - portName or null for none
  - getProtocol
```
public String getProtocol()
```
    The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, TCP, SSL, or UDP, depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancer or for Traffic director for more information.
    
    Returns:
    
    value or null for none
  - setProtocol
```
public BackendService setProtocol(String protocol)
```
    The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, TCP, SSL, or UDP, depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancer or for Traffic director for more information.
    
    Parameters:
    
    protocol - protocol or null for none
  - getRegion
```
public String getRegion()
```
    [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
    
    Returns:
    
    value or null for none
  - setRegion
```
public BackendService setRegion(String region)
```
    [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
    
    Parameters:
    
    region - region or null for none
  - getSecurityPolicy
```
public String getSecurityPolicy()
```
    [Output Only] The resource URL for the security policy associated with this backend service.
    
    Returns:
    
    value or null for none
  - setSecurityPolicy
```
public BackendService setSecurityPolicy(String securityPolicy)
```
    [Output Only] The resource URL for the security policy associated with this backend service.
    
    Parameters:
    
    securityPolicy - securityPolicy or null for none
  - getSelfLink
```
public String getSelfLink()
```
    [Output Only] Server-defined URL for the resource.
    
    Returns:
    
    value or null for none
  - setSelfLink
```
public BackendService setSelfLink(String selfLink)
```
    [Output Only] Server-defined URL for the resource.
    
    Parameters:
    
    selfLink - selfLink or null for none
  - getSessionAffinity
```
public String getSessionAffinity()
```
    Type of session affinity to use. The default is NONE. Session affinity is not applicable if the --protocol is UDP. When the loadBalancingScheme is EXTERNAL, possible values are NONE, CLIENT_IP, or GENERATED_COOKIE. You can use GENERATED_COOKIE if the protocol is HTTP or HTTPS. When the loadBalancingScheme is INTERNAL, possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. When the loadBalancingScheme is INTERNAL_SELF_MANAGED, possible values are NONE, CLIENT_IP, GENERATED_COOKIE, HEADER_FIELD, or HTTP_COOKIE.
    
    Returns:
    
    value or null for none
  - setSessionAffinity
```
public BackendService setSessionAffinity(String sessionAffinity)
```
    Type of session affinity to use. The default is NONE. Session affinity is not applicable if the --protocol is UDP. When the loadBalancingScheme is EXTERNAL, possible values are NONE, CLIENT_IP, or GENERATED_COOKIE. You can use GENERATED_COOKIE if the protocol is HTTP or HTTPS. When the loadBalancingScheme is INTERNAL, possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. When the loadBalancingScheme is INTERNAL_SELF_MANAGED, possible values are NONE, CLIENT_IP, GENERATED_COOKIE, HEADER_FIELD, or HTTP_COOKIE.
    
    Parameters:
    
    sessionAffinity - sessionAffinity or null for none
  - getTimeoutSec
```
public Integer getTimeoutSec()
```
    The backend service timeout has a different meaning depending on the type of load balancer. For more information read, Backend service settings The default is 30 seconds.
    
    Returns:
    
    value or null for none
  - setTimeoutSec
```
public BackendService setTimeoutSec(Integer timeoutSec)
```
    The backend service timeout has a different meaning depending on the type of load balancer. For more information read, Backend service settings The default is 30 seconds.
    
    Parameters:
    
    timeoutSec - timeoutSec or null for none
  - set
```
public BackendService set(String fieldName,
                          Object value)
```
    Overrides:
    
    set in class GenericJson
  - clone
```
public BackendService clone()
```
    Overrides:
    
    clone in class GenericJson

Class BackendService

Nested Class Summary

Nested classes/interfaces inherited from class com.google.api.client.util.GenericData

Nested classes/interfaces inherited from class java.util.AbstractMap

Nested classes/interfaces inherited from interface java.util.Map

Constructor Summary

Method Summary

Methods inherited from class com.google.api.client.json.GenericJson

Methods inherited from class com.google.api.client.util.GenericData

Methods inherited from class java.util.AbstractMap

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

Constructor Detail

BackendService

Method Detail

getAffinityCookieTtlSec

setAffinityCookieTtlSec

getBackends

setBackends

getCdnPolicy

setCdnPolicy

getConnectionDraining

setConnectionDraining

getCreationTimestamp

setCreationTimestamp

getCustomRequestHeaders

setCustomRequestHeaders

getDescription

setDescription

getEnableCDN

setEnableCDN

getFingerprint

decodeFingerprint

setFingerprint

encodeFingerprint

getHealthChecks

setHealthChecks

getIap

setIap

getId

setId

getKind

setKind

getLoadBalancingScheme

setLoadBalancingScheme

getName

setName

getPort

setPort

getPortName

setPortName

getProtocol

setProtocol

getRegion

setRegion

getSecurityPolicy

setSecurityPolicy

getSelfLink

setSelfLink

getSessionAffinity

setSessionAffinity

getTimeoutSec

setTimeoutSec

set

clone