Show / Hide Table of Contents

Class Backend

Message containing information of one individual backend.

Inheritance
object
Backend
Implements
IDirectResponseSchema
Inherited Members
object.Equals(object)
object.Equals(object, object)
object.GetHashCode()
object.GetType()
object.MemberwiseClone()
object.ReferenceEquals(object, object)
object.ToString()
Namespace: Google.Apis.Compute.alpha.Data
Assembly: Google.Apis.Compute.alpha.dll
Syntax
public class Backend : IDirectResponseSchema

Properties

BalancingMode

Specifies how to determine whether the backend of a load balancer can handle additional traffic or is fully loaded. For usage guidelines, see Connection balancing mode. Backends must use compatible balancing modes. For more information, see Supported balancing modes and target capacity settings and Restrictions and guidance for instance groups. Note: Currently, if you use the API to configure incompatible balancing modes, the configuration might be accepted even though it has no impact and is ignored. Specifically, Backend.maxUtilization is ignored when Backend.balancingMode is RATE. In the future, this incompatible combination will be rejected.

Declaration
[JsonProperty("balancingMode")]
public virtual string BalancingMode { get; set; }
Property Value
Type Description
string

CapacityScaler

A multiplier applied to the backend's target capacity of its balancing mode. The default value is 1, which means the group serves up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot configure a setting larger than 0 and smaller than 0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service. Not available with backends that don't support using a balancingMode. This includes backends such as global internet NEGs, regional serverless NEGs, and PSC NEGs.

Declaration
[JsonProperty("capacityScaler")]
public virtual float? CapacityScaler { get; set; }
Property Value
Type Description
float?

CustomMetrics

List of custom metrics that are used for CUSTOM_METRICS BalancingMode.

Declaration
[JsonProperty("customMetrics")]
public virtual IList<BackendCustomMetric> CustomMetrics { get; set; }
Property Value
Type Description
IList<BackendCustomMetric>

Description

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

Declaration
[JsonProperty("description")]
public virtual string Description { get; set; }
Property Value
Type Description
string

ETag

The ETag of the item.

Declaration
public virtual string ETag { get; set; }
Property Value
Type Description
string

Failover

This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.

Declaration
[JsonProperty("failover")]
public virtual bool? Failover { get; set; }
Property Value
Type Description
bool?

Group

The fully-qualified URL of an instance group or network endpoint group (NEG) resource. To determine what types of backends a load balancer supports, see the Backend services overview. You must use the fully-qualified URL (starting with https://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported. If haPolicy is specified, backends must refer to NEG resources of type GCE_VM_IP.

Declaration
[JsonProperty("group")]
public virtual string Group { get; set; }
Property Value
Type Description
string

MaxConnections

Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.

Declaration
[JsonProperty("maxConnections")]
public virtual int? MaxConnections { get; set; }
Property Value
Type Description
int?

MaxConnectionsPerEndpoint

Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.

Declaration
[JsonProperty("maxConnectionsPerEndpoint")]
public virtual int? MaxConnectionsPerEndpoint { get; set; }
Property Value
Type Description
int?

MaxConnectionsPerInstance

Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.

Declaration
[JsonProperty("maxConnectionsPerInstance")]
public virtual int? MaxConnectionsPerInstance { get; set; }
Property Value
Type Description
int?

MaxRate

Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.

Declaration
[JsonProperty("maxRate")]
public virtual int? MaxRate { get; set; }
Property Value
Type Description
int?

MaxRatePerEndpoint

Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.

Declaration
[JsonProperty("maxRatePerEndpoint")]
public virtual float? MaxRatePerEndpoint { get; set; }
Property Value
Type Description
float?

MaxRatePerInstance

Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.

Declaration
[JsonProperty("maxRatePerInstance")]
public virtual float? MaxRatePerInstance { get; set; }
Property Value
Type Description
float?

MaxUtilization

Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.

Declaration
[JsonProperty("maxUtilization")]
public virtual float? MaxUtilization { get; set; }
Property Value
Type Description
float?

Preference

This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default

Declaration
[JsonProperty("preference")]
public virtual string Preference { get; set; }
Property Value
Type Description
string

Implements

IDirectResponseSchema
In this article
Back to top Generated by DocFX