BackendService (Compute Engine API v1 (Rev. 127) 1.22.0)

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

All Implemented Interfaces:

java.lang.Cloneable, java.util.Map<java.lang.String,java.lang.Object>
```
public final class BackendService
extends com.google.api.client.json.GenericJson
```
A BackendService resource. This resource defines a group of backend virtual machines and their serving capacity.
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
  com.google.api.client.util.GenericData.Flags
- Nested classes/interfaces inherited from class java.util.AbstractMap
  java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>
- Nested classes/interfaces inherited from interface java.util.Map
  java.util.Map.Entry<K,V>

Constructor Summary

Constructors
Constructor and Description

BackendService()

Constructors
Constructor and Description
`BackendService()`

Method Summary

Methods
Modifier and Type	Method and Description
`BackendService`	`clone()`
`byte[]`	`decodeFingerprint()` Fingerprint of this resource.
`BackendService`	`encodeFingerprint(byte[] fingerprint)` Fingerprint of this resource.
`java.lang.Integer`	`getAffinityCookieTtlSec()` Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE.
`java.util.List<Backend>`	`getBackends()` The list of backends that serve this BackendService.
`ConnectionDraining`	`getConnectionDraining()`
`java.lang.String`	`getCreationTimestamp()` [Output Only] Creation timestamp in RFC3339 text format.
`java.lang.String`	`getDescription()` An optional description of this resource.
`java.lang.Boolean`	`getEnableCDN()` If true, enable Cloud CDN for this BackendService.
`java.lang.String`	`getFingerprint()` Fingerprint of this resource.
`java.util.List<java.lang.String>`	`getHealthChecks()` The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService.
`java.math.BigInteger`	`getId()` [Output Only] The unique identifier for the resource.
`java.lang.String`	`getKind()` [Output Only] Type of resource.
`java.lang.String`	`getName()` Name of the resource.
`java.lang.Integer`	`getPort()` Deprecated in favor of portName.
`java.lang.String`	`getPortName()` Name of backend port.
`java.lang.String`	`getProtocol()` The protocol this BackendService uses to communicate with backends.
`java.lang.String`	`getRegion()` [Output Only] URL of the region where the regional backend service resides.
`java.lang.String`	`getSelfLink()` [Output Only] Server-defined URL for the resource.
`java.lang.String`	`getSessionAffinity()` Type of session affinity to use.
`java.lang.Integer`	`getTimeoutSec()` How many seconds to wait for the backend before considering it a failed request.
`BackendService`	`set(java.lang.String fieldName, java.lang.Object value)`
`BackendService`	`setAffinityCookieTtlSec(java.lang.Integer affinityCookieTtlSec)` Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE.
`BackendService`	`setBackends(java.util.List<Backend> backends)` The list of backends that serve this BackendService.
`BackendService`	`setConnectionDraining(ConnectionDraining connectionDraining)`
`BackendService`	`setCreationTimestamp(java.lang.String creationTimestamp)` [Output Only] Creation timestamp in RFC3339 text format.
`BackendService`	`setDescription(java.lang.String description)` An optional description of this resource.
`BackendService`	`setEnableCDN(java.lang.Boolean enableCDN)` If true, enable Cloud CDN for this BackendService.
`BackendService`	`setFingerprint(java.lang.String fingerprint)` Fingerprint of this resource.
`BackendService`	`setHealthChecks(java.util.List<java.lang.String> healthChecks)` The list of URLs to the HttpHealthCheck or HttpsHealthCheck resource for health checking this BackendService.
`BackendService`	`setId(java.math.BigInteger id)` [Output Only] The unique identifier for the resource.
`BackendService`	`setKind(java.lang.String kind)` [Output Only] Type of resource.
`BackendService`	`setName(java.lang.String name)` Name of the resource.
`BackendService`	`setPort(java.lang.Integer port)` Deprecated in favor of portName.
`BackendService`	`setPortName(java.lang.String portName)` Name of backend port.
`BackendService`	`setProtocol(java.lang.String protocol)` The protocol this BackendService uses to communicate with backends.
`BackendService`	`setRegion(java.lang.String region)` [Output Only] URL of the region where the regional backend service resides.
`BackendService`	`setSelfLink(java.lang.String selfLink)` [Output Only] Server-defined URL for the resource.
`BackendService`	`setSessionAffinity(java.lang.String sessionAffinity)` Type of session affinity to use.
`BackendService`	`setTimeoutSec(java.lang.Integer timeoutSec)` How many seconds to wait for the backend before considering it a failed request.

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

- Constructor Detail
  - BackendService
```
public BackendService()
```
- Method Detail
  - getAffinityCookieTtlSec
```
public java.lang.Integer getAffinityCookieTtlSec()
```
    Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. 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 for TTL is one day. When the load balancing scheme is INTERNAL, this field is not used.
    
    Returns:
    value or null for none
  - setAffinityCookieTtlSec
```
public BackendService setAffinityCookieTtlSec(java.lang.Integer affinityCookieTtlSec)
```
    Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. 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 for TTL is one day. When the load balancing scheme is INTERNAL, this field is not used.
    
    Parameters:
    affinityCookieTtlSec - affinityCookieTtlSec or null for none
  - getBackends
```
public java.util.List<Backend> getBackends()
```
    The list of backends that serve this BackendService.
    
    Returns:
    value or null for none
  - setBackends
```
public BackendService setBackends(java.util.List<Backend> backends)
```
    The list of backends that serve this BackendService.
    
    Parameters:
    backends - backends 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 java.lang.String getCreationTimestamp()
```
    [Output Only] Creation timestamp in RFC3339 text format.
    
    Returns:
    value or null for none
  - setCreationTimestamp
```
public BackendService setCreationTimestamp(java.lang.String creationTimestamp)
```
    [Output Only] Creation timestamp in RFC3339 text format.
    
    Parameters:
    creationTimestamp - creationTimestamp or null for none
  - getDescription
```
public java.lang.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(java.lang.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 java.lang.Boolean getEnableCDN()
```
    If true, enable Cloud CDN for this BackendService. When the load balancing scheme is INTERNAL, this field is not used.
    
    Returns:
    value or null for none
  - setEnableCDN
```
public BackendService setEnableCDN(java.lang.Boolean enableCDN)
```
    If true, enable Cloud CDN for this BackendService. When the load balancing scheme is INTERNAL, this field is not used.
    
    Parameters:
    enableCDN - enableCDN or null for none
  - getFingerprint
```
public java.lang.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.
    
    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.
    
    Returns:
    Base64 decoded value or null for none
    Since:
    
    1.14
    
    See Also:
    getFingerprint()
  - setFingerprint
```
public BackendService setFingerprint(java.lang.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.
    
    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.
    
    Since:
    
    1.14
    
    See Also:
    The value is encoded Base64 or {@code null} for none.
  - getHealthChecks
```
public java.util.List<java.lang.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 internal load balancing, a URL to a HealthCheck resource must be specified instead.
    
    Returns:
    value or null for none
  - setHealthChecks
```
public BackendService setHealthChecks(java.util.List<java.lang.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 internal load balancing, a URL to a HealthCheck resource must be specified instead.
    
    Parameters:
    healthChecks - healthChecks or null for none
  - getId
```
public java.math.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(java.math.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 java.lang.String getKind()
```
    [Output Only] Type of resource. Always compute#backendService for backend services.
    
    Returns:
    value or null for none
  - setKind
```
public BackendService setKind(java.lang.String kind)
```
    [Output Only] Type of resource. Always compute#backendService for backend services.
    
    Parameters:
    kind - kind or null for none
  - getName
```
public java.lang.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(java.lang.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 java.lang.Integer getPort()
```
    Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. This cannot be used for internal load balancing.
    
    Returns:
    value or null for none
  - setPort
```
public BackendService setPort(java.lang.Integer port)
```
    Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. This cannot be used for internal load balancing.
    
    Parameters:
    port - port or null for none
  - getPortName
```
public java.lang.String getPortName()
```
    Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL. When the load balancing scheme is INTERNAL, this field is not used.
    
    Returns:
    value or null for none
  - setPortName
```
public BackendService setPortName(java.lang.String portName)
```
    Name of backend port. The same name should appear in the instance groups referenced by this service. Required when the load balancing scheme is EXTERNAL. When the load balancing scheme is INTERNAL, this field is not used.
    
    Parameters:
    portName - portName or null for none
  - getProtocol
```
public java.lang.String getProtocol()
```
    The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, TCP and SSL. The default is HTTP. For internal load balancing, the possible values are TCP and UDP, and the default is TCP.
    
    Returns:
    value or null for none
  - setProtocol
```
public BackendService setProtocol(java.lang.String protocol)
```
    The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, TCP and SSL. The default is HTTP. For internal load balancing, the possible values are TCP and UDP, and the default is TCP.
    
    Parameters:
    protocol - protocol or null for none
  - getRegion
```
public java.lang.String getRegion()
```
    [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
    
    Returns:
    value or null for none
  - setRegion
```
public BackendService setRegion(java.lang.String region)
```
    [Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services.
    
    Parameters:
    region - region or null for none
  - getSelfLink
```
public java.lang.String getSelfLink()
```
    [Output Only] Server-defined URL for the resource.
    
    Returns:
    value or null for none
  - setSelfLink
```
public BackendService setSelfLink(java.lang.String selfLink)
```
    [Output Only] Server-defined URL for the resource.
    
    Parameters:
    selfLink - selfLink or null for none
  - getSessionAffinity
```
public java.lang.String getSessionAffinity()
```
    Type of session affinity to use. The default is NONE. When the load balancing scheme is EXTERNAL, can be NONE, CLIENT_IP, or GENERATED_COOKIE. When the load balancing scheme is INTERNAL, can be NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. When the protocol is UDP, this field is not used.
    
    Returns:
    value or null for none
  - setSessionAffinity
```
public BackendService setSessionAffinity(java.lang.String sessionAffinity)
```
    Type of session affinity to use. The default is NONE. When the load balancing scheme is EXTERNAL, can be NONE, CLIENT_IP, or GENERATED_COOKIE. When the load balancing scheme is INTERNAL, can be NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. When the protocol is UDP, this field is not used.
    
    Parameters:
    sessionAffinity - sessionAffinity or null for none
  - getTimeoutSec
```
public java.lang.Integer getTimeoutSec()
```
    How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
    
    Returns:
    value or null for none
  - setTimeoutSec
```
public BackendService setTimeoutSec(java.lang.Integer timeoutSec)
```
    How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.
    
    Parameters:
    timeoutSec - timeoutSec or null for none
  - set
```
public BackendService set(java.lang.String fieldName,
                 java.lang.Object value)
```
    Overrides:
    
    set in class com.google.api.client.json.GenericJson
  - clone
```
public BackendService clone()
```
    Overrides:
    
    clone in class com.google.api.client.json.GenericJson

Compute Engine API v1 (revision 127)

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

Constructor Detail

BackendService

Method Detail

getAffinityCookieTtlSec

setAffinityCookieTtlSec

getBackends

setBackends

getConnectionDraining

setConnectionDraining

getCreationTimestamp

setCreationTimestamp

getDescription

setDescription

getEnableCDN

setEnableCDN

getFingerprint

decodeFingerprint

setFingerprint

encodeFingerprint

getHealthChecks

setHealthChecks

getId

setId

getKind

setKind

getName

setName

getPort

setPort

getPortName

setPortName

getProtocol

setProtocol

getRegion

setRegion

getSelfLink

setSelfLink

getSessionAffinity

setSessionAffinity

getTimeoutSec

setTimeoutSec

set

clone